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I  INTRODUCTION 


A.       STATEMENT  OF  OBJECTIVES 

•  An  objective  of  this  study  is  to  determine  the  overall  characteristics  of  the 
TSO  and  TSO  equivalent  systems  market  in  the  U.S.  To  do  this,  we  have 
investigated:  ' 

The  general  characteristics  of  the  market. 

The  size  and  growth  rate  of  the  market. 

Competitive  systems  and  their  use. 

•  The  primary  objective  is  to  determine  overall  use  of  timesharing  software  in 
the  large  IBM  CPU  market  for  1980  and  to  forecast  timesharing  usage  for 
1985. 

•  Within  the  overall  market,  the  size  of  individual  segments  was  determined  by: 

The  number  of  terminals  used. 
Thirty  to  80  terminals. 
Eighty  plus  terminals. 


INPUT 


The  type  of  user  environment. 

University  or  laboratory.  (Scientific  and  engineering  problenn 
solving.) 

Corporations.  (Business  programming  and  problem  solving.) 
The  category  of  mainframe  used  for  the  timesharing  system. 
IBM  and  PCM. 
Univac. 

CDC.  .  ^ 

Honeywell. 

DEC. 

Burroughs  and  NCR. 

To  determine  the  number  and  type  of  CPUs  used  for  timesharing,  configura- 
tions are  broken  out  by: 

The  number  and  type  of  CPUs  used. 

The  number  of  terminals  used. 

The  operating  system  used. 

Another  objective  is  to  provide  information  on  current  suppliers  of  TSO-type 
systems  being  used  in  the  U.S. 

System  name  and  vendor. 


Purchase  or  lease  terms. 
Any  available  literature. 

A  preliminary  evaluation  of  each  competitor. 
B.       RESEARCH  METHODOLOGY 

•  To  study  the  overall  market  size  and  structure,  INPUT  used: 

Data  from  the  Computer  Intelligence  Corporation  data  base  on  large 
IBM  and  PCM  sites. 

INPUT'S  existing  forecasts  of  CPU  and  timesharing  market  growth. 

•  To  study  the  vendors  of  software  that  competes  with  TSO,  INPUT  conducted 
interviews  with  seven  vendors  to  determine: 

The  number  of  product  installations. 

Market  growth  rates. 

Marketing  strategies. 

Vendor  strengths  and  weaknesses. 

Assessment  of  the  timesharing  software  market  by  the  competing 
vendors. 

•  To  study  the  effect  of  other  mainframe  vendors  on  the  IBM  timesharing 
market,  INPUT  used  data  from  the  CIC  data  base  and  interviewed  five 
mainframe  vendors  to  determine: 
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Market  size  and  growth. 

Marketing  strategies  in  the  IBM  market. 

The  ability  to  compete. 

•  Because  preliminary  data  showed  a  definite  trend  to  the  use  of  mini-  and 
microcomputers  for  interactive  problem  solving,  selective  interviews  with 
vendors  of  these  systems  were  conducted  to  determine: 

The  long-term  effect  on  large  systems  used  for  timesharing. 

Marketing  strategies. 

Anticipated  growth  rates. 

•  A  few  selected  users  were  interviewed  to  assist  in  determining: 

Competing  software  quality. 

Required  vendor  characteristics. 

Minimum  features  for  software  product  viability. 
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M    EXECUTIVE  SUMMARY 


EXECUTIVE  SUMMARY 


CONCLUSIONS 

The  market  for  TSO-type  timesharing  software  on  very  large  IBM  mainframes 
in  the  U.S.  is  excellent. 

The  market  will  grow  substantially,  from  1,350  user  installations  in 
1980  to  3,100  user  installations  in  1985,  as  shown  in  Exhibit  1 1- 1. 

The  greatest  growth  will  occur  among  the  largest  users  (more  than  80 
terminals). 

The  business  market  will  offer  greater  potential  than  the  university/- 
laboratory  market. 

The  market  growth  will  not  slow  down  during  the  forecast  time  period. 

New  users  are  moving  up  into  the  MVS/timesharing  environment  from 
smaller  systems. 

Existing  users  of  large  IBM  and  PCM  computers  are  adding  additional 
systems,  or  converting  batch  systems  for  on-line  problem  solving  and 
programming. 
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In  the  U.S.,  public  data  networks  (Telenet,  Tymnet)  have  not  had  a  significant 
impact  on  the  large  timesharing  market,  particularly  with  IBM  mainframe 
users. 


In  the  IBM  market,  asynchronous  terminals,  which  are  easily  supported 
by  the  public  data  networks,  are  less  likely  to  be  used  than  3270s. 

Users  with  large  networks  have  plans  to  convert  to  SNA  or,  in  some 
cases,  to  use  other  private  network  products. 

There  are  several  well-established  TSO  competitors  in  the  market  today. 

Most  products  are  well-advertised  and  promoted. 

A  few  vendors  have  been  successful  by  targeting  specific  market 
niches. 

There  are  several  reasons  why  TSO  users  are  reluctant  to  change  systems: 
Uncertainties  of  conversion: 
Time  involved. 
Cost. 

Added  burden  to  retrain  users  on  the  use  of  a  new  system. 

Uncertainty  of  the  acceptance  of  a  new  product  by  people 
accustomed  to  TSO. 

Anticipation  of  new  IBM  software. 

Reluctance  to  use  anything  that  is  not  directly  supported  by  IBM. 
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Not  perceived  as  important  enough  to  justify  a  change. 

•  The  price  range  for  timesharing  software  is  $15,000  to  $30,000  for  a  perpetual 
license. 

An  additional  maintenance  fee  is  charged  after  the  first  two  years  of 
use. 

The  annual  maintenance  fee  is  typically  $1,000  to  $1,500  but  can  be  as 
high  as  15%  of  the  license  fee. 

•  A  new  product  entering  the  market  would  not  need  to  have  all  the  features  of 
other  competing  products. 

Lack  of  features  would  limit  market  share  but  would  not  preclude 
market  entry. 

As  a  product  evolves  over  time,  users  will  pay  additional  fees  for  added 
capabilities. 

•  TSO  is  recognized  by  most  users  to  be  an  inefficient  system  that  lacks  several 
important  functions.  When  users  turn  to  alternatives,  they  are  looking  for: 

More  efficient  use  of  the  CPU. 

User  friendliness.  " 

Full  screen  and  file  editing. 

Foreground  processing  of  programs. 

More  efficient  disk  storage  utilization. 

Easy  document  preparation  for  all  users. 
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•  TSO  has  a  poor  reputation  among  many  users.  Typical  negative  comments 
about  TSO  are: 

"Very  slow  response  time." 

"Uses  too  much  CPU  resources." 

"Complicated  sign-on  and  command  structure." 

"Output  processing  is  poor." 

"Difficult  to  get  acceptance  from  programmers  who  have  used  other 
systems." 

•  Because  of  TSO's  reputation  as  an  inefficient  and  difficult  system  to  use,  first- 
time  timesharing  users  are  often  open  to  alternative  products. 

•  Japanese  companies  are  not  known  in  the  U.S.  as  potential  software  vendors. 

•  The  key  to  success  is  not  technical  excellence.  Rather,  it  is  broad  sales 
coverage,  effective  promotion  and  advertising,  and  a  product  that  is  very 
reliable. 

•  Developing  a  direct  sales  force  to  cover  the  entire  U.S.  would  be  too  expensive 
unless  the  Hitachi  timesharing  product  is: 

Aimed  at  a  specific  market  niche. 

Accompanied  by  other  products  so  that  a  salesman  could  offer  several 
products  on  each  sales  call. 
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B.  RECOMMENDATIONS 


•  To  most  effectively  sell  Hitachi  timesharing  software  in  the  U.S.,  INPUT 
recommends  affiliating  with: 

A  software  broker  offering  nationwide  coverage. 

An  existing  software  vendor  that  does  not  now  offer  a  timesharing 
software  system. 

•  Before  beginning  a  sales  campaign  for  Hitachi  software  in  the  U.S.,  it  will  be 
necessary  to  have  already  completed  several  preparatory  work  phases: 

The  product  must  be  thoroughly  tested  in  a  variety  of  customer  sites. 

The  product  must  be  well  documented.  All  literature  must  be  easily 
understood  by  users  familiar  with  IBM  documentation. 

High-quality  promotion  materials  must  be  developed.  These  can  be 
expected  to  receive  wide  distribution  before  many  prospects  pay  to 
become  users. 

•  The  Hitachi  software  product  should  be  listed  in  the  software  directories  that 
many  users  refer  to  when  selecting  a  product.  These  include: 

ICP  Quarterly.  ■ 

Datapro. 

Auerboch. 

•  Market  entry  for  a  new  product  in  the  U.S.  market  should  begin  as  soon  as 
possible.    There  are  already  several  successful  products,  and  the  competing 
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vendors  are  becoming  better  entrenched  by  increasing  their  market  share  and 
product  mix.  / 

•  Because  we  do  not  know  the  features  and  specifications  of  the  Hitachi 
timesharing  software  product,  INPUT  is  not  able  to  recommend  which  market 
segment,  either  user  type  or  user  size,  Hitachi  should  concentrate  on. 

•  For  further  in-depth  study,  INPUT  recommends  that  Hitachi  investigate  the 
following  products  and  vendors: 

ROSCOE  from  Applied  Data  Research;  ROSCOE  because  it  is  the  most 
successful  competitor  despite  having  fewer  features  than  its  competi- 
tors. As  important  as  the  product  is,  ADR  itself  should  be  studied  as  a 
highly  successful  software  vendor. 

Tone-3  and  Tone-4  from  Tone  Software;  Tone-3  because  of  its  success 
in  a  particular  market  niche;  Tone-4  because  it  competes  on  a  feature 
basis  with  the  latest  upgrades  to  TSO. 

Wylbur  and  Superwylbur  from  On-Line  Business  Systems;  Wylbur 
because  it  has  been  the  model  for  user-friendly  systems,  offering 
excellent  user  features.  Yet,  despite  having  a  good  reputation,  these 
systems  have  never  achieved  the  market  penetration  of  ROSCOE  and 
Tone. 

C.       FUTURE  TRENDS  AND  CHARACTERISTICS  IN  USAGE  OF  TIMESHARING 
SYSTEMS 

•  For  at  least  ten  years  now,  there  has  been  an  almost  universal  belief  that  on- 
line access  to  program  development  tools  results  in  greater  programming 
productivity. 
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In  INPUT'S  mail  survey,  the  largest  group  of  respondents  named  on-line 
interactive  program  development  as  the  single  most  successful  factor 
for  productivity  improvement. 

•  This  belief  is  supported  primarily  by  logic.  . 

It  is  reasonable  to  assume  that  the  periods  of  waiting  for  batch  outputs 
of  trial  runs  are  largely  unproductive. 

Even  when  the  programmer  attempts  to  multiplex  the  time  by  working 
on  program  B  while  waiting  for  program  A's  output,  the  mental  "gear 
shifting"  from  one  line  of  thought  to  another  probably  degrades 
productivity. 

•  There  is  a  nagging  suspicion  that  excessive  on-line  access  can  be  detrimental 
to  productivity  by  encouraging  sloppy  work.  This  suspicion  was  expressed  by  a 
number  of  people  INPUT  interviewed.  It  has  also  been  reported  in  other 
industry  literature. 

However,  it  can  also  be  reasonably  argued  that  this  fault  is  not  inherent 
in  the  interactive  environment  and  can  be  avoided  by  establishing 
discipline  through  appropriate  management  practices. 

•  The  elements  of  the  interactive  development  environment  are  by  now  common 
to  many  varieties  of  hardware  and  to  many  software  monitors.  They  include: 

A  mechanism  for  controlling  the  communications  lines  to  a  number  of 
terminals. 

An  editor  to  allow  terminal  operators  to  enter,  modify  and  examine 
text,  especially  source  code  and  listings. 
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A  command  language  to  enable  terminal  users  to  invoke  assembly, 
compilation,  link  editing  and  execution  of  programs,  often  with  dynamic 
tracing  capabilities  and  symbolic  debugging  features. 

A  "HELP"  menu  to  guide  the  uninitiated  in  the  details  of  the  interactive 
system. 

•  When  these  elements  are  reentrant,  the  efficiency  of  the  system  is  greatly 
enhanced  by  the  ability  to  service  multiple  editing  operations  with  a  single 
copy  of  a  reentrant  editor. 

•  TSO  and  CMS  are  the  two  best-known  on-line  systems  from  IBM. 

TSO  ("Time  Share  Option")  is  designed  to  reconcile  the  batch  orienta- 
tion of  IBM  operating  systems,  especially  MVT,  SVS  and  MVS,  with  the 
need  to  service  interactive  program  development  and  testing.  TSO 
combines  the  functions  of  a  communications  monitor,  controlling  a 
large  number  of  users'  terminals,  with  such  services  as  interactive  data 
set  creation,  text  editing,  compilation  and  test  runs.  To  the  operating 
system,  TSO  appears  to  be  just  another  "job." 

CMS  (Conversational  Monitor  System)  is  the  "native"  operating  system 
of  VM/370,  a  system  designed  to  permit  execution  of  many  different 
operating  systems  on  a  single  CPU.  CMS  services  a  single-terminal 
user  with  facilities  similar  to  TSO.  By  running  multiple  "CMS 
machines,"  a  VM-controlled  CPU  can  create  a  multiterminal  interactive 
environment  similar  to  TSO. 

•  More  recently  developed  operating  systems  from  other  vendors  do  not  need 
artifices  like  TSO  or  CMS,  because  they  are  inherently  designed  to  support  an 
interactive  environment. 
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The  TOPS  10  and  TOPS20  operating  systems  for  the  DEC  PDF- 10  and  -20 
(now  called  DEC  systems  10  and  20)  are  examples  of  an  operating 
system  designed  to  support  both  batch  and  interactive  workloads. 

The  operating  system  for  the  Wang  2200  and  VS  computer  lines  are 
entirely  interactive-oriented,  and  assume  that  each  user  has  a  CRT 
workstation.  Batch  workload  is  handled  by  treating  the  batch  input  and 
output  as  if  they  come  from,  or  are  destined  to,  a  dummy  or  simulated 
interactive  terminal. 

•  The  underlying,  common  problem  of  all  existing  tools  and  aids  is  their  ad  hoc 
nature;  they  each  address  a  specific  area  independently  of  other  related  areas. 
For  example: 

Existing  requirements  languages  have  no  interface  to  the  detail  design 
and  implementation  phase. 

Structured  design  and  analysis  methodologies  have  little  or  no  transition 
mechanism  into  coding. 

Structured  design  and  analysis  methodologies  address  the  entire  life 
cycle,  but  only  as  a  "checklist";  i.e.,  without  tools  to  address  the 
substance  of  the  life  cycle  activities. 

•  Another  major  problem  is  the  scarcity  and  relative  ineffectiveness  of  tech- 
niques, tools  and  aids  to  influence  the  maintenance  activity  directly. 

Useful  tools  not  now  commercially  available  would  be: 

A  global  cross-reference  generator,  operating  across  the  entire 
application  system  of  main  program,  called  subroutines,  job 
control  statements,  utility  parameter  lists,  etc. 
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A  mechanism  to  retroactively  populate  the  data  dictionary 
(related  to  the  cross-reference  generator). 

k  global  documentation  generator/editor  that  would  facilitate 
structured,  "reusable"  documentation. 

A  regression  test  harness  or  driver. 

The  absence  of  these  tools  leaves  a  rather  big  gap  in  productivity 
improvement,  since  INPUT  estimates  that  the  majority  of  the  life  cycle 
costs,  at  least  of  major  projects,  are  due  to  maintenance  rather  than 
development  activities. 

What  is  clearly  needed  is  a  system  to  integrate  the  automation  of  all  life  cycle 
activities  into  a  uniform,  compatible  and  communicating  set  of  techniques  and 
tools. 

Using  the  existing  state  of  the  art  as  a  base,  without  requiring  any  revolu- 
tionary breakthroughs,  it  is  possible  to  visualize  such  a  system,  and  to  list  its 
major  features  and  characteristics. 

It  will  have  an  interactive  "workbench"  to  serve  the  needs  not  only  of 
coders,  but  also  of  system  specifiers,  system  designers  and  maintenance 
personnel. 

The  system  specifiers  and  designers,  working  interactively  via  their 
unique  "workbench,"  will  accumulate  the  specifications  and  overall 
design  of  the  system,  cast  in  a  "requirements  language." 

The  requirements  language  processor  will  store  the  elements  of  the 
system  specifications  and  design  in  the  same  data  base  and  data 
dictionary  that  will  eventually  be  used  for  the  operation  of  the  system 
being  designed. 
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The  requirements  language  processor  will  perform  consistency  checks 
and  produce  documentation  to  serve  the  rest  of  the  system's  life  cycle. 

The  requirements  language  processor  will  produce  one  or  several 
alternate  "trial"  designs,  and  will  forecast  their  performance  under  a 
range  of  operating  assumptions. 

Specifiers  and  designers  will  think  in  terms  of  a  uniform,  company-wide 
structured  design  and  analysis  methodology. 

Detail  designers  and  coders,  supported  by  their  own  unique  "work- 
bench," will  convert  the  procedures  and  data  designated  in  the  specifi- 
cations phase  into  executable  code,  using  a  very  high-level  language 
supported  by  the  appropriate  code  generator. 

They  will  be  able  to  search  a  large  library  of  previously  developed 
standard  functions  and  skeletons  by  context,  to  determine  which  of  the 
existing  modules  and  skeletons  already  satisfy  portions  of  the  new 
design. 

Some  end  user  requirements  will  not  even  reach  the  DP  department, 
because  the  installation's  data  base  management  system,  with  its 
associated  query/retrieval  language,  will  allow  them  to  create  mini- 
applications  without  assistance. 

Throughout  the  entire  process,  the  activities  of  all  personnel  will  be 
guided  by  a  checklist  provided  by  a  system  development  methodology. 

Progress  reports  and  personnel/resource  loading  data  will  be  automat- 
ically produced  by  the  system's  automated  components.  For  this 
purpose,  these  components  will  be  able  to  exchange  data. 

Documentation  will  be  produced  automatically  from  the  data  in  the 
requirements  data  base  and  data  dictionary. 
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Both  planned  and  unplanned  enhancements  to  the  system  will  be  handled 
as  "projects,"  although  they  will  not  require  the  complete  SDM 
checklist. 

There  will  be  an  automated  "version  control"  system  that  permits 
binary  modules  to  be  unambiguously  identified  with  the  source  code  and 
design  versions  that  produced  the  binary  modules.  This  system  will  also 
control  what  goes  into  the  "production"  version  of  the  system. 

Note  that  all  of  the  above  capabilities  already  exist  in  some  automated  form 
or  another. 

What  is  missing  is  the  "glue"  that  binds  the  individual  techniques  into  a 
uniform,  compatible,  communicating  system. 

The  other  missing  element  is  the  automation  of  program  validation  and 
checking. 

Clearly,  future  progress  must  then  proceed  along  two  lines  of  attack: 

Developing  integrated  systems  of  uniform,  communicating  tools. 

Developing  effective,  simple  tools  to  automate  program  validation  and 
checking. 
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Ill       MARKET  POSITIONS  AND  TRENDS 


A.       THE  LARGE  CPU-MVS  ENVIRONMENT 

•  Based  on  data  from  the  Computer  Intelligence  Corporation  (CIC)  data  base  and 
corroborated  from  other  sources,  we  have  determined  that  there  are,  as  of 
year  end  1980,  2,300  computers  installed  in  the  U.S.  in  the  size  range  under 
study,  as  shown  in  Exhibit  lll-l.  ^  ' 

•  Of  these  2,300  CPUs,  1,975  of  them  are  using  the  MVS  system. 

•  Of  the  1,975  CPUs  using  MVS,  1,677  are  used  as  dedicated  or  part-time 
timesharing  systems. 

•  Of  the  1,677  CPUs  supporting  timesharing,  I  ,A^77  support  30  or  more  terminals. 

•  Of  those  1,477  CPUs,  1,351  are  used  in  either  a  business  or  a  university/labora- 
tory environment. 

•  It  is  these  1,351  CPUs  that  are  discussed  in  the  following  sections. 


-  19  - 


INPUT 


EXHIBIT  III-l 


IBM  AND  PCM 
1  980  CPU  POPULATION  IN  U.S. 


CATEGORY 

NUMBER  OF 
us,    1  you 

TOTAL  OF  VERY  LARGE  CPUs 
(168s,  3032s,  3033s  AND 
AMDAHL) 

100% 

2,300 

USING  MVS 

86 

1,  975 

USING  TIMESHARING  FULL 
OR  PART-TIMF 

73 

1,677 

SUPPORTING  30  OR  MORE 
TERMINALS 

(30-80  TERMINALS  =  353) 

(81  OR  MORE  TERMINALS  =  1,124)* 

64 

15 

49 

1,477 

USED  IN  BUSINESS  OR 
LABORATORIES 
BUSINESS  =  1,057 
LABORATORY  OR 
UNIVERSITY  =  294** 

59 
46 

13 

1,351 

*LESS  THAN  30  TERMINALS:  200 


**GOVERNMENT:  126 
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B.       THE  UNIVERSITY/LABORATORY  ENVIRONMENT 

•  As  shown  in  Exhibits  lli-2  and  lil-3,  IBM's  TSO  is  the  dominant  timesharing 
software  system  used  in  the  university/laboratory  environment. 

•  Discussions  with  users  in  this  environment  indicated  that  by  the  time  a  large 
user  is  running  under  MVS,  he  is  usually  committed  to  using  IBM  software,  such 
as  TSO. 

•  Perhaps  surprisingly,  there  are  many  MVS  users  in  the  university/laboratory 
environment. 

IBM  is  still  the  dominant  supplier,  and  MVS  is  the  premier  operating 
system  for  all  large-scale  CPUs  in  any  environment. 

MVS  is  the  standard  for  Amdahl  CPUs. 

Universities  use  MVS  partly  because  their  students  are  being  trained  for 
positions  in  businesses  which  are  likely  to  have  large  IBM  CPUs  using 
MVS. 

MVS  will  be  required  for  future  CPU  products  from  IBM. 

•  There  is  not  a  significant  difference  between  the  attitudes  of  university/- 
laboratory  people  and  those  in  business  who  use  very  large  IBM  systems.  In 
both  cases,  the  systems  are  managed  by  DP  professionals. 

In  the  case  of  the  university,  if  end  users  demand  and  pay  for  other 
systems,  the  DP  department  will  be  more  likely  to  accede  to  these 
demands  than  in  the  business  environment. 
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EXHIBIT  m-2 


TSO  MARKET  SHARES  IN  UNIVERSITIES/LABORATORIES 

(30-80  TERMINALS) 


EST 

IMATED 

MARKET  SHARE 

SOFTWARE 

NUMBER  OF 

PERCENT  AS 

VENDOR 

SYSTEM 

SI 

TES 

YEAR  1980 

OF  YEAR  1980 

IBM 

TSO 

50 

71 

ADR 

ROSCOE 

13 

19 

CULLINANE 

INTERACT 

0 

ON-LINE 
BUSINESS 
SYSTEMS 

WYLBUR  AND 

SUPERWYLBUR 

6 

9 

TONE 

TONE-3  AND 

0 

SOFTWARE 

TONE-4 

McGILL 

UNIVERSITY 
(MARKETED 

MUSIC 

0 

BY  IBM) 

OTHERS 

1 

1 

TOTAL 

70 

100%  . 
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TSO  MARKET  SHARES  IN  UNIVERSITIES /LABORITORIES 

(OVER  80  TERMINALS) 


ESTIMATED 

MARKET  SHARE 

COCTU/A  DP 
r  1  W  A  K  t 

M  I  IM  P  P  R  OP 

DPDr'PMT  AC 

VENDOR 

SYSTEM 

SITES  YEAR  1980 

OF  YEAR  1980 

IBM 

TSO 

184 

82% 

ADR 
ML/  fx 

1  R 

1  o 

o 
o 

CULLINANE 

INTERACT 

2 

1 

ON-LINE 
BUSINESS 
SYSTEMS 

WYLBUR  AND 

16 

SUPERWYLBUR 

7 

TONE 
SOFTWARE 

TONE-3  AND 
TONE-4 

2 

1 

McGILL 

UNIVERSITY 
(MARKETED 

MUSIC 

0 

BY  IBM) 

OTHERS 

2 

1 

TOTAL 

224 

100% 
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•  Market  share  data  shows  that  longevity  in  the  nnarketplace  is  the  key  to 
market  share.  Both  ROSCOE  and  Wylbur  have  been  available  for  six  or  more 
years. 

•  In  the  university/laboratory  -  but  not  MVS  -  environment,  users  are  more  likely 
to  experiment  with  and  become  users  of  competitive  software.  An  example 
would  be  the  limited  success  of  MUSIC  that  runs  only  under  VM. 

C.  THE  BUSINESS  CORPORATION  ENVIRONMENT 

•  As  shown  in  Exhibits  lli-4  and  lil-5,  the  market  share  data  do  not  drastically 
differ  between  the  business  environment  and  the  university  environment. 

•  TSO  is  the  clear  market  leader,  with  ROSCOE  and  the  various  versions  of  Wylbur 
well  behind. 

•  Again,  product  quality  does  not  guarantee  immediate  market  share.  Vendors 
take  several  years  to  build  up  to  a  10%  share. 

•  It  is  significant  that  no  generalized  timesharing  system  is  clearly  a  leader  in 
one  environment  rather  than  the  other.  Selling  in  one  environment  is  as 
difficult  or  as  easy  as  the  other. 

D.  THE  TOTAL  LARGE  CPU  ENVIRONMENT 

•  Exhibit  III-6  shows  the  market  share  data  for  all  of  the  major  competing  software 
systems  in  the  large  CPU  environment. 
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TSO  MARKET  SHARES  IN  BUSINESS  CORPORATIONS 

(30-80  TERMINALS) 


ESTIMATED 

MARKET  SHARE 

SOFTWARE 

NUMBER  OF 

PERCENT  AS 

VENDOR 

SYSTEM 

SITES  YEAR  1980 

OF  YEAR  1980 

IBM 

TSO 

195 

77 

ADR 

KvJbCUL 

30 

1  T 

1  L 

CULLINANE 

INTERACT 

2 

\ 

ON-LINE 
BUSINESS 
SYSTEMS 

WYLBUR  AND 

21 

8 

SUPERWYLBUR 

TONE 

TONE-3  AND 

1 

SOFTWARE 

TONE-4 

3 

McGILL 

UNIVERSITY 
(MARKETED 

MUSIC 

0 

BY  IBM) 

OTHERS 

2 

1 

TOTAL 

253 

100% 
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EXHIBIT  III-5 


TSO  MARKET  SHARES  IN  BUSINESS  CORPORATIONS 
(OVER  80  TERMINALS) 


EST  IMATFD 

MARK  FT  *=;HARF 

SOFTWARE 

NUMBER  OF 

PERCENT  AS 

VENDOR 

SYSTEM 

SITES  YEAR  1980 

Qp  YEAR   1  QRO 

IBM 

TSO 

649 

81% 

ADR 

ROSCOE 

78 

■  - 

10 

CULLINANE 

INTERACT 

8 

1 

ON-LINE 
BUSINESS 
SYSTEMS 

WYLBUR  AND 

51 

SUPERWYLBUR 

6 

TONE 

TONE-3  AND 

1 

SOFTWARE 

TONE-4 

9 

McGILL 

UNIVERSITY 
(MARKETED 

MUSIC 

0 

BY  IBM) 

OTHERS 

9 

1 

TOTAL 

804 

100% 
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EXHIBIT  111-6 


MARKET  SHARES  OF  TIMESHARING  SOFTWARE  - 
VERY  LARGE  SYSTEMS  (IBM/168,  3032,  3033;  AMDAHL) 


OPERATING  SYSTEM 

MARKET 
SHARE 
(PERCENT) 

SOFTWARE 
SYSTEM 

VSl 

SVS 

MVS 

OTHERS 

TOTAL 

TSO 

0 

38 

1,3U0 

0 

1 ,378 

74% 

22 

15 

174 

14 

225 

1  2 

INTERACT 

3 

0 

12 

0 

15 

1 

WYLBUR 

5 

0 

26 

1 

32 

2 

SUPERWYLBUR 

0 

2 

92 

2 

96 

5 

TONE-3 

45 

0 

0 

0 

45 

2 

TONE-4 

0 

0 

18 

0 

18 

1 

MUSIC 

0 

0 

0 

12 

12 

1 

OTHERS 

2 

15 

9 

30 

2 

TOTAL 

79 

57 

1 ,677 

38 

1 ,  851 

100% 
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•  When  broken  down  by  operating  system  rather  than  by  user  classification  or 
nunnber  of  terminals,  certain  products  are  only  sold  into  a  limited  0/S 
environment  (Tone  3  and  Tone  4). 

•  Further,  it  can  be  seen  that  some  products  have  done  exceptionally  well  In  a 
particular  environment  (ROSCOE  with  SVS  or  Superwylbur  with  MVS). 

•  Remember  that  Exhibit  III-6  includes  CPUs  with  less  than  30  terminals  and 
governmental  users. 

E.  USE  OF  NON-IBM  CPUs 

•  Analysis  of  the  CIC  file  showed  that  in  only  3%  of  the  identified  sites  were 
large  mainframes,  such  as  CDC,  Univac  I  100  or  DEC- 10,  used  alongside  IBM 
or  PCM  CPUs.  Since  all  of  these  systems  support  timesharing,  it  is  not 
possible  to  separate  timesharing  usage  from  nontimesharing  usage,  as  shown 
in  Exhibits  III-7  and  III-8. 

•  All  of  these  competing  CPUs  were  shown  in  locations  running  MVS. 

•  Fifty-five  percent  of  those  users  who  have  both  a  non-IBM  CPU  and  an  IBM  or 
PCM  CPU  are  not  TSO  users.  This  is  approximately  20%  higher  than  all  non- 
TSO  users. 

F.  THE  MEDIUM  TO  LARGE  CPU  TIMESHARING  MARKET 

•  Although  not  formally  a  part  of  this  study,  it  was  necessary  to  analyze  the 
market  shares  of  TSO  and  its  competitors  in  the  medium  to  large  CPU  range,  as 
shown  in  Exhibit  III-9,  in  order  to  develop  data  for  the  large  to  very  large  CPU 
range,  as  shown  in  Exhibit  III-6. 
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EXHIBIT  III-9 


MARKET  SHARES  OF  TIMESHARING  SOFTWARE  - 
MEDIUM-LARGE  SYSTEMS  (IBM/158,  3031  ,  155,  165;  AS6) 


OPERATING  SYSTEM 

MARKET 
SHARE 
(PERCENT) 

SOFTWARE 
SYSTEM 

VSl 

svs 

MVS 

OTHERS 

TOTAL 

TSO 

0 

56 

997 

0 

1,053 

58% 

1  \  v_y  o     kJ  l. 

49 

21 

31  9 

36 

425 

INTERACT 

21 

1 

28 

0 

50 

3 

WYLBUR 

9 

1 

16 

2 

28 

2 

SUPERWYLBUR 

6 

2 

44 

7 

59 

3 

TONE-3 

120 

0 

0 

0 

120 

7 

TONE-4 

0 

0 

14 

0 

14 

1 

MUSIC 

0 

0 

0 

8 

8 

OTHERS 

7 

2 

17 

14 

40 

2 

TOTAL 

212 

83 

1,435 

67 

1,797 

100% 
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This  is  obviously  a  good  market  also,  although  it  has  two  major  differences 
when  compared  to  the  very  large  CPU  market: 

The  number  of  terminals  supported  per  system  is  considerably  smaller. 

The  growth  rate  for  both  CPUs  in  general  and  for  timesharing  in  this 
size  range  is  less  than  in  the  very  large  CPU  range. 
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IV       SYSTEM  CONFIGURATIONS 


A.       CPUs  PER  SITE 

•  Based  on  data  from  the  Computer  Intelligence  Corporation  (CiC)  data  base  of 
installed  CPUs,  Exhibit  IV-I  indicates  how  the  use  of  MVS  and  ISO  varies  with 
the  number  of  CPUs  per  site. 

•  Over  half  (52%)  of  all  sites  using  very  large  IBM  and  PCM  CPUs  have  only  one 
CPU.  But  these  sites  account  for  only  27%  of  the  CPUs  in  this  size  range. 

Eighty-one  percent  of  these  sites  report  they  are  using  MVS. 

Forty-seven  percent  of  these  MVS  users  report  using  ISO. 

•  Sites  with  two  of  these  CPUs  represent  28%  of  all  sites  and  have  30%  of  the 
CPUs. 

Eighty-nine  percent  of  two  CPU  sites  report  using  MVS. 
Sixty-one  percent  of  these  MVS  users  report  using  ISO. 

•  Sites  v/ith  three  or  more  large  CPUs  represent  only  20%  of  all  sites  but  have 
over  43%  of  the  CPUs. 
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EXHIBIT  IV-1 


ANALYSIS  OF  LARGE  CPU  USERS 
BASED  ON  CPUs  PER  SITE 


CPU  USERS 

1  CPU 
(PERCENT) 

2  CPUs 
(PERCENT) 

3  UK  MORE 

CPUs 
(PERCENT) 

SHARE  OF  TOTAL  SITES 

52% 

28% 

20% 

SHARE  OF  CPUs 

27 

30 

43 

PERCENT  OF  SITES  IN  THIS 
CATEGORY  RUNNING  MVS 

81 

89 

92 

PERCENT  OF  SITES  RUNNING  MVS 
THAT  ALSO  USE  TSO 

47 

61 

65 

SHARE  OF  ALL  TSO  USERS 

41% 

33% 

26% 
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The  average  number  of  CPUs  used  by  these  sites  is  four,  although  there 
are  a  few  sites  in  the  CiC  data  base  with  eight  or  more  CPUs. 

Ninety-two  percent  of  these  sites  use  MVS. 

Sixty-five  percent  of  the  MVS  users  also  run  TSO. 

While  available  data  are  too  sketchy  to  be  conclusive,  use  of  competitive 
timesharing  systems  is  apparently  less  frequent  among  these  multi-CPU 
users. 

B,  USE  OF  OTHER  MAINFRAMES 

•  As  reported  in  Chapter  III,  only  3%  of  all  sites  reported  using  a  large  non-IBM- 
compatible  CPU  along  with  the  large  IBM  and  PCM  CPUs  in  this  study. 

•  Two  percent  reported  using  Burroughs,  NCR,  Univac  or  Honeywell  CPUs. 
These  are  primarily  used  in  the  business  environment. 

•  Only  1%  of  users  reported  also  using  CDC,  CRAY  or  large  DEC  CPUs,  and 
these  are  all  in  the  university/laboratory  environment. 

The  largest  reported  timesharing  user  had  over  350  terminals  on  a  CDC 
computer. 

C.  NUMBER  OF  TERMINALS 

•  As  shown  in  Exhibit  IV-2,  users  of  large  CPUs  reported  using  a  large  number  of 
terminals. 
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EXHIBIT  lV-2 


ANALYSIS  OF  NUMBER  OF  TERMINALS  USED 
IN  TIMESHARING  ENVIRONMENT 
BY  LARGE  CPU  USERS 


CPU  USERS 

<30 
TERMINALS 
(PERCENT) 

30-80 
TERMINALS 
(PERCENT) 

>80 
TERMINALS 
(PERCENT) 

SHARE  OF  TOTAL  SITES 

11% 

23% 

66% 

PERCENT  OF  SITES  RUNNING 
MVS 

85 

82 

87 

PERCENT  OF  SITES  RUNNING 
MVS  THAT  ALSO  USE  TSO 

U5 

51 

58 

SHARE  OF  ALL  TSO  USERS 

9% 

20% 

71% 
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The  terminals  counted  in  this  study  were  3270  types,  other  CRTs  and 
teleprinters.  Industry-specific  and  RJE  ternninals  were  excluded. 

•  Sixty-six  percent  of  all  sites  reported  using  more  than  80  terminals. 

These  sites  also  have  the  largest  percentage  of  MVS  and  MVS/TSO 
users. 

Most  importantly,  71%  of  all  sites  reporting  using  TSO  are  in  the  more- 
than-80-terminal  category. 

•  The  30-  to  80-terminal  category  represents  23%  of  all  sites. 

This  category  reports  the  lowest  usage  of  MVS  -  82%. 

•  Only  I  1%  of  the  large  user  sites  reported  using  less  than  30  terminals. 

•  The  maximum  number  of  terminals  used  on  general-purpose  IBM  systems 
appears  to  be  in  the  250-300  range. 

Some  CDC  users  reported  as  many  as  350  terminals. 

Special-purpose  systems  (e.g.,  airline  reservations)  go  much  higher. 

D.       USER  CLASSiFiCATION 

•  Seventy-two  percent  of  all  sites  reported  by  CIC  are  classified  as  business 
corporations  according  to  their  Standard  Industry  Classification  (SIC)  code. 

•  Twenty  percent  of  the  sites  are  classified  as  universities,  other  schools  or 
laboratories. 
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Eight  percent  are  government-related  installations. 


E.       COMMENTS  ON  CiC  DATA 

•  The  CiC  data  base  contains  user  information  on  a  site  basis.  CIC  does  not 
claim  to  list  100%  of  all  sites,  so  other  data  and  INPUT'S  best  judgement  have 
been  used  in  developing  all  figures  shown  in  this  report  except  those  in  IV-A 
through  IV-D  above. 

•  The  CIC  data  base  is  most  accurate  on  CPU  data.  It  becomes  less  accurate,  or 
less  up-to-date,  the  further  from  the  CPU  it  gets.  For  instance: 

Reported  usage  of  TSO  would  be  less  complete  than  for  MVS. 

Terminals  listed  in  the  data  base  would  not  be  as  accurate  as  data  on 
disks  or  CPUs. 

•  CIC  has  only  recently  begun  systematically  to  capture  data  on  software 
packages  that  compete  with  TSO.  Therefore,  market  share  data  was  neces- 
sarily derived  from  vendor  interviews  and  other  sources  available  to  INPUT. 

•  These  comments  do  not  diminish  the  value  of  the  CIC  data.  Rather,  they  only 
point  out  that  this  data  base  is  a  very  useful  tool  that  must  be  used  by 
experienced  analysts.  CIC  has  the  best  file  of  its  kind  available. 
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V        TIMESHARING  PRODUCTS  AND  VENDORS 


A.  ALL  COMPETITION 

•  The  total  market  for  on-line  programming  and  problem  solving  becomes  more 
complex  over  time.  Today,  the  viable  competitors  are: 

Timesharing  service  companies. 

In-house  timesharing  based  on  large  CPUs  -  the  object  of  this  study. 

Special-purpose,  large  CPUs. 

Minicomputers. 

Microcomputers. 

•  The  timesharing  services  companies  will  not  be  discussed  as  part  of  this  study. 
They  do  not  represent  a  market  for  new  timesharing  software  products. 

B.  SOFTWARE  PRODUCTS  FOR  IBM-TYPE  COMPUTERS 

•  TSO:  the  timesharing  option  of  IBM's  operating  systems. 
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Known  as  an  inefficient  and  difficult  system  to  use. 

Despite  its  drawbacks,  TSO  is  by  far  the  most  widely  used  timesharing 
software  package. 

IBM  has  been  attempting  to  combat  TSO  competitors  by  introducing 
TSO  enhancements.  The  most  important  of  these  is  the  Structured 
Programming  Facility  (SPF)  which  offers  some  of  the  features  of 
competitors  such  as  Wylbur. 

RQSCOE;  the  vendor  is  Applied  Data  Research  (ADR). 

ADR  claims  that  there  are  over  900  installations  worldwide. 

In  the  U.S.,  ADR  has  nine  sales  offices  with  an  average  of  five 
salespersons  and  at  least  one  SE  in  each. 

ADR  stresses  ease  of  use,  compared  to  TSO,  as  the  major  selling 
point. 

The  largest  known  ROSCOE  network  supports  over  250 
terminals;  the  average  is  40-50  terminals. 

ADR  states  that  the  largest  competitor  today  is  the  Structured 
Programming  Facility  (SPF)  of  TSO. 

Many  ROSCOE  users  also  use  TSO. 

Wylbur  and  Superwylbur;  the  vendor  is  On-Line  Business  Systems  (OBS). 

Wylbur  was  originally  developed  by  Stanford  University.  OBS  was 
formed  in  1976  to  market  Wylbur. 
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The  Superwylbur  package  was  developed  by  Optimum  Systems,  Inc. 
(OSI)  out  of  public  domain  versions  of  Wylbur. 

OSI  has  sold  its  software  business  to  OBS. 

There  are  over  200  installations  of  Wylbur  and  Superwylbur. 

Wylbur  is  sold  on  the  basis  of  greater  capability  as  well  as  ease  of  use 
and  efficiency. 

-         SPF  is  now  a  major  competitor  of  Wylbur. 

OBS  feels  that  word  processing  systems  are  now  providing  competition 
since  that  was  a  major  capability  of  Wylbur. 

Interact:  the  vendor  is  Cull  inane  Software. 

This  is  also  a  derivative  of  the  original  Wylbur. 

There  are  over  80  installations  worldwide. 

The  average  system  supports  75  terminals.  The  largest  known  installa- 
tion is  approximately  175  terminals. 

Interact  does  not  provide  foreground  execution.  It  is  only  a  program- 
ming aid. 

Interact  is  sold  almostexclusively  where  other  Cullinane  products  are  sold. 

Tone-3  and  Tone-4;  the  vendor  is  Tone  Software. 

Tone-3  is  derived  from  public  domain  TSO.  It  was  developed  to  run  in  a 
VSI  environment. 
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Tone  claims  over  200  installations  of  Tone-3  worldwide. 

Tone  uses  only  two  salespersons  in  the  U.S. 

Tone-4  is  an  outright  TSO  replacennent,  MVS  only. 

Designed  to  cut  overhead,  it  has  few  enchancements. 

It  requires  little  technical  support  or  training  because  it  closely  copies 
TSO. 

MUSIC:  the  vendor  is  McGill  University,  Montreal,  Canada. 

MUSIC  is  developed  specifically  for  a  student  environment. 

It  contains  its  own  operating  system  -  runs  under  VM/370. 

Two-thirds  of  the  approximately  40  installations  are  in  schools. 

McGill  is  moving  slowly  to  make  this  a  moneymaker. 

The  main  benefit  claimed  is  reduced  hardware  requirement. 

Most  installations  support  a  non-professional  programmer  environment. 

MUSIC  is  sold  through  IBM  as  a  contributed  program  product. 

All  these  software  vendors  felt  the  market  was  growing  at  25-50%  per  year. 

Pricing  is  not  a  major  issue  in  this  market.  All  are  sold  mostly  on  full  payout 
leases  at  $800-1,000  per  month  for  24  months.  None  has  a  full  purchase  price 
of  over  $30,000,  or  less  than  $17,500.  Rentals  are  offered  by  all  vendors,  but 
very  few  installations  choose  this  option;  it  is  primarily  for  government 
agencies  that  can  only  get  funding  for  a  limited  period  of  time. 
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•  All  vendors  see  IBM  as  the  major  competitor  in  the  MVS  environment.  This  is 
an  indication  that  the  market  has  not  reached  a  maximum  level  of  penetration 
by  non-IBM  competitors. 

•  There  Is  another  category  of  software  products  that  is  sometimes  not  clearly 
distinguished  from  timesharing-type  systems.  These  are  data  communications 
monitors.  They  compete  more  with  CICS  or  with  IMS/DC  than  with  TSO. 

These  products  are  sometimes  used  to  develop  limited  systems  that  do 
provide  on-line  services  such  as  remote  program  execution. 

Some  of  the  products  in  this  category  are: 

Intercomm. 

Task/Master. 

Com-Plete. 

Environ/ 1 . 

Shadow  II. 

Users  of  these  products  who  do  not  have  a  timesharing  software  system 
are  usually  the  easiest  prospects  for  selling  timesharing  software. 

C       COMPUTER  SYSTEMS 

•  All  vendors  of  computer  systems  today  offer  timesharing  software.  All  of  the 
vendors  interviewed  were  certain  that  they  offered  a  more  cost-effective 
system  with  TSO  than  IBM.  Despite  this,  not  one  has  a  strategy  to  try  to 
displace  such  IBM  systems. 
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Digital  Equipment  Corporation  (DEC):  the  DEC  product  that  would  compete 
directly  with  a  large  IBM  system  is  the  SYSTEM- 10.  The  operating  system  is  a 
timesharing  system.  The  software  cannot  be  broken  into  separate  pieces. 


The  DEC  System- 10  is  more  than  12  years  old. 

DEC  is  planning  a  performance  upgrade  for  the  System- 10  along  with 
increased  marketing  effort. 

The  System- 10  has  done  very  well  in  the  university/laboratory  environ- 
ment, poorly  in  the  business  world. 

DEC  people  know  of  very  few  cases  where  a  System- 10  is  located  at  an 
IBM  site. 

Control  Data  Corporation  (CDC);  CDC  claims  to  have  over  500  installations 
of  its  large  CPUs  (6600,  7600,  Cyber-175,  -176  and  -205)  that  use  CDC's 
Interactive  Facility  (lAF)  software  option. 

CDC  systems  are  successful  when  pure  numeric  problem  solving  is 
required. 

The  average  system  supports  over  100  terminals;  one  as  many  as  350. 

CDC  will  aggressively  compete  with  IBM  for  new  installations;  it  will 
not  target  IBM  accounts  in  an  attempt  to  displace  the  IBM  system. 

The  main  area  of  competition  is  minicomputers.  Labs  have  a  difficult 
time  getting  large  government  grants  for  systems;  several  smaller 
systems  go  through  more  easily  on  separate  budgets. 

Sperry  Univac;  the  Univac  I  100  family  of  large  computers  has  been  successful 
in  both  the  business  and  laboratory  environments. 


-  44  - 


Univac  has  a  large  product  family  so  that  a  user  can  select  from  a 
compatible  family  of  processors  starting  with  systems  similar  in  power 
to  a  3031  and  going  all  the  way  up  to  the  power  of  a  3081. 

Univac  has  only  one  operating  system  for  the  1100  family,  now  known 
asllOOO/S. 

There  are  three  levels  of  timesharing  software  available  with  I  100  0/S: 

Conversational  Timesharing  System  (CTS)  is  the  most  frequently 
used,  with  over  600  installations.  It  is  similar  in  function  to  TSO, 
but  easier  to  use. 

Demand  Processor  is  the  lowest-level,  easiest-to-use  system. 
There  are  approximately  500  installations. 

High  Volume  Time  Sharing  (HVTS)  offers  CTS-level  capability 
but  much  better  CPU  efficiency.  The  system  will  easily  support 
300-500  terminals.  There  are  still  less  than  10  HVTS  users. 

Honeywell:  the  MULTICS  timesharing  system  that  Honeywell  acquired  with 
the  GE  product  line  10  years  ago  keeps  Honeywell  in  the  ranks  of  major 
timesharing  vendors. 

The  MULTICS  system  was  originally  developed  at  M.l.T.  with  a  govern- 
ment grant.  (The  project  was  related  to  the  ARPANET  project.) 

MULTICS  is  used  by  many  government  installations  today. 

System  security  is  one  of  MULTICS's  strengths,  the  reason  for  its 
success  in  military  and  other  government  agencies. 

Honeywell,  like  CDC,  will  aggressively  go  after  new  business  but  does 
not  actively  attempt  to  displace  IBM  systems. 
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•  Burroughs  and  NCR:  these  two  companies  offer  timesharing  software  as  part 
of  their  product  line.  Neither  has  been  successful  with  the  product  in  a  pure 
timesharing  environment.  Each  is  most  successful  supporting  business  applica- 
tions on-line,  such  as  banking.  Neither  should  be  considered  as  a  possible 
competitor  in  the  TSO  environment. 

P.       MINICOMPUTER  SYSTEMS  V 

•  These  systems  from  DEC,  HP,  Data  General,  Prime  and  many  others  are 
seldom  used  today  in  a  non-interactive  manner  when  they  are  used  for 
programming  or  problem  solving.  The  software  systems  assume  interactive 
use  and  even  make  batch  processing  comparatively  difficult. 

Minicomputers  are  the  most  significant  factor  in  the  university/labora- 
tory timesharing  market. 

Minicomputers  are  easy  to  justify  in  individual  department  or  grant 
budgets. 

Minicomputers  have  user-friendly  systems  compared  to  large  computer 
software  systems,  particularly  TSO. 

Minicomputers  offer  more  than  enough  computer  power  for  most 
applications.  If  not,  get  a  larger  mini,  use  a  timesharing  service  or  run 
batch  on  a  large  system.  Only  as  a  last  resort  would  a  user  acquire  or 
share  a  large  CPU. 

•  The  growth  of  the  minicomputer  market  does  not  indicate  the  demise  of  large 
timesharing  systems.  Rather,  it  just  means  that  many  new  applications  will  be 
implemented  slowly,  if  at  all,  on  the  large  systems. 
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•  Further,  until  practical  software  exists  to  control  a  distributed  data  base, 
large  centralized  systems  will  be  necessary  for  many  organizations  dependent 
on  the  use  of  massive  data  volumes. 

E.  MICROCOMPUTERS 

•  These  personal  or  very  small  business  computers  must  be  mentioned  because 
they  are  already  a  viable  alternative  to  large  CPUs. 

A  large  San  Francisco-based  bank  is  acquiring  3,000  Apple  systems 
faster  than  it  is  adding  3270-type  terminals.  Over  1,000  systems  will  be 
installed  in  1981.  None  of  these  is  ordered  through  the  data 
processing  department.  Dissatisfaction  with  TSO  among  the  users,  both 
its  difficult  use  and  its  cost,  is  the  major  incentive. 

A  nationwide  distribution  company  has  ordered  over  2,000  systems  for 
its  sales  force.  Each  salesperson  will  have  their  own  system  for 
territory  management.  The  plan  to  issue  portable  terminals  and  put  the 
applications  on  central  computers  was  judged  too  costly  to  implement 
and  operate. 

•  Many  micros  already  are  used  for  word  processing  -  one  of  the  strong  points  of 
several  timesharing  software  systems. 

•  To  increase  programmer  productivity,  some  installations  are  letting  pro- 
grammers use  micros  at  home.  Edited  and  tested  programs  on  modules  are 
submitted  via  the  on-line  system  only  when  completed. 

•  Microcomputers  will  have  an  effect  much  like  minicomputers.  They  will  slow 
but  not  stop  the  growth  of  large,  centralized  computer  systems.  The  effect  of 
micros  will  be  felt  as  much  in  the  business  environment  as  in  the  university/ 
laboratory. 
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F.       OTHER  IBM  PRODUCTS 


•  While  the  timesharing  software  market  has  provided  a  large  market  for 
alternatives  to  ISO,  IBM  itself  has  been  slow  to  meet  the  need. 

•  The  most  successful  IBM  alternative  has  been  the  VM/370  operating  system 
with  the  Conversational  Monitor  System  (CMS).  The  VM/CMS  environment  is 
very  common  in  the  medium-size  computer  range  because  it  allows  users  to 
run  their  older  DOS  systems  simultaneously  as  they  upgrade  to  and  run  OS 
(MVS)  systems. 

•  Despite  users  having  TSO  as  part  of  MVS,  some  prefer  to  stay  with  CMS 
because  it  is  so  much  easier  to  use  than  TSO. 

•  IBM  now  offers  added  facilities  known  as  Structured  Programming  Facility 
(SPF)  for  both  TSO  and  CMS.  SPF  permits  such  functions  as  browsing  through 
program  files,  editing,  assembling  and  testing  directed  through  a  terminal. 

•  As  indicated  by  both  vendors  and  users,  SPF  provides  the  major  competition 
for  those  competing  vendors. 

•  As  noted  above,  IBM  is  even  willing  to  market  a  competitive  product  such  as 
MUSIC.  They  don't  push  MUSIC  outside  of  the  university  environment,  but  in 
that  environment,  it  gives  them  a  product  that  better  competes  against  DEC 
and  CDC.  ..  , 
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ANALYSIS  OF  SUCCESSFUL  MARKET  AND  PRODUCT  STRATEGIES 


•  In  the  process  of  interviewing  vendors,  we  attempted  to  determine  the  key 
elements  of  their  success  in  the  market.  This  was  carried  out  further  in  the 
interviews  with  users. 


A.       PRODUCT  FEATURES 


•  This  study  demonstrated  what  had  been  determined  before  in  studies  of  other 
software  products.  Lack  of  features  does  not  prevent  the  sale  of  a  product,  it 
only  limits  market  share  or  slows  growth. 

•  Large  users  who  do  seek  an  alternative  to  TSO  will  look  for  features  such  as 
full  screen  edit,  foreground  processing  and  document  preparation  (WP).  To 
move  away  from  TSO  almost  demands  that  they  get  more  functions. 

•  Secondly,  users  changing  from  TSO  will  look  for  better  utilization  of  resources 
-  always  CPU,  sometimes  disk. 

•  Thirdly,  they  want  a  more  user-friendly  system,  which  all  of  the  vendors  claim 
to  offer. 

•  First-time  users  will  buy  anything.  They  have  usually  heard  of  the  inefficiency 
of  TSO  and  welcome  an  alternative.    Only  if  they  are  dependent  on  IBM  for 
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systems  support,  an  unlikely  situation  in  a  TSO  installation,  will  TSO  be  the 
first  choice. 

•  Of  course  there  are  a  few  cases  where  the  user  buys  IBM  and  nothing  else. 
This  is  more  common  in  the  insurance  industry  than  in  any  other. 

•  Therefore,  for  a  system  supporting  up  to  80  terminals,  having  all  the  features 
of  SPF  is  not  necessary.  A  plan  to  add  functions  in  the  future  will  add 
credibility  but  should  never  be  over-emphasized. 


B.       SALES  COVERAGE 


•  If  you  have  a  unique  market  niche  into  which  only  your  product  fits,  as  Tone 
did  with  its  TSO  version  for  VSI  sites,  a  small  salesforce  with  a  telephone 
will  suffice. 

•  When  competing  head-to-head  for  most  sales,  broad  coverage  is  required. 
ADR  has  over  50  salespersons  in  the  U.S.,  Cullinane  has  almost  25. 

•  On  the  other  hand,  Wylbur  and  Superwylbur,  with  more  features  than  ROSCOE 
or  Interact,  are  sold  by  a  lO-person  salesforce.  They  have  also  achieved  less 
market  penetration. 

•  To  broaden  coverage  effectively,  all  competitors  list  their  products  in  such 
directories  as  the  ICP  Quarterly,  Datapro  and  Auerbach.  It  is  also  important 
to  be  listed  in  new  product  sections  of  communications-oriented  magazines. 

•  One  method  to  get  broad  sales  coverage  quickly  would  be  to  have  the  product 
distributed  by  a  vendor  of  a  TP  monitor  or  a  data  base  system  that  does  not 
offer  a  timesharing  system. 
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C.       SYSTEMS  SUPPORT 


•  It  is  very  important  to  have  user-installable  software  and  eas/-to-understand 
documentation.  If  this  is  achieved,  a  vendor  does  not  need  systems  engineers 
to  support  each  installation. 

•  Larger  vendors  can  afford  an  SE  in  each  sales  office  because  of  the  number  of 
installations  as  well  as  the  number  of  products  sold. 

•  Small  vendors  can  get  by  with  no  support  in  the  field  if  they  make  the  initial 
investment  in  testing  and  documenting  the  product. 


D.       A  COMPLETE  PRODUCT  LINE 


•  A  vendor  with  more  than  one  product  gains  several  advantages. 

He  is  perceived  as  a  more  stable  vendor. 

He  will  be  able  to  maximize  sales  and  support  resources. 

He  will  be  less  vulnerable  to  a  product  announcement  by  IBM. 

•  Having  only  a  single  product  to  offer  would  make  it  virtually  impossible  to  get 
started  on  your  own  without  a  large  up-front  investment. 
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APPENDIX  A:         PRODUCT  LITERATURE 


•         This   appendix   contains   vendor -provided   documentation   on   the  following 
products: 

Tone-3  and  Tone-4. 

Wylbur. 

Superwylbur. 

ROSCOE. 

Interact. 

IBM  SPF. 
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TONE-3   AND  TONE-4 


CAPABILITY 

TONE  3  provides  the  capability  for  OSA/Sl   installations  to 

extend  the  following  batch  capabilities  to  the  terminal  user  in  a 
TSO  compatible  format, 

•  Edit  standard  VSI  datasets 

•  Submit  jobs  directly  to  the  JES  job  queue. 

•  Review  jobs  directly  from  the  JES  output  spool. 

•  Interactively  execute  system  commands,  programs  and 
utilities. 

•  Inquire  system  status.  /  ?r  J 
OVERVIEW 

The  system  is  designed  to  meet  the  following  goals: 

•  Improve  the  effectiveness  of  the  users  computer  system. 

•  Provide  a  time  sharing  system  facility  designed  for  the 
VSl  system. 

•  Provide  command  compatible  with  IBM  TSO. 
.  •    Reduce  the  overhead  associated  with  TCAM. 

•  Eliminate  the  overhead  associated  v;ith  user  swapping. 

•  Minimize  the   scheduling/operator  interaction  with  the 
terminal  user. 

AVAILABILITY:  TONE  3  extends  to  the  terminal  user  the  batch 
capabilities  of  job  submittal  and  output  retrieval.  Furthermore, 
TONE  3  provides  for  the  interactive  execution  of  programs, 
using  the  terminal  as  an  input  device,  and  concurrently,  an 
outDut  device.  .      'v.^,  .  ■, 

UScABILITY:  These  capabilities  are  provided  in  a  format  which 
\\  :ompaiible  with  the  IBM  time  sharing  option  (TSO);  this 
language  has  become  the  standard  for  IBM  computer  time 
sharing  users.  Significant  enhancements  to  useability  have 
been  provided  for  the  users  of  3270  type  terminals  through  the 
TOi-jE  3  3270  support  package. 

EFFICIENCY:  The  implementation  of  most  time  sharing  sys- 
tems has  added  significant  overhead  for  the  purpose  of 
managing  the  telecommunications  network  and  the  interaction 
of  the  multiple  online  users.  The  IBM  MVT/SVS  systems 
include  these  components;  they  are  telecommunications 
access  method  (TCAM).  and  user  swapping,  TONE  3  manages 
most  terminal  networks  using  basic  telecommunications 
access  method  (BTAM).  a  simpler  and  more  efficient  tele- 
communication.': mcniior,  TONE  3  throughput  is  enhanced  by 
i!s  use  of  the  multitasking  and  virtual  memory  management 
e'ements  of  the  VSl  operating  system,  which  eliminate  the 
'oquirement  for  user  swapping. 

TIMELINESS:  TONE  3  provides  the  terminal  user  with  the 
Capability  10  interact  with  the  comouler  when  it  is  desireable. 
The  computer  resources  are  immediately  allocated  to  process 
tr:e  data  as  it  is  input,  and  results  may  be  displayed  for  the 
user  at  a  time  wh^-n  those  results  may  still  impact  the  process. 

PRODUCTIVITY:  Tn-}  computer  system  is  most  effective  when 
II  iS  availdbi-;  !o  I'^e  user,  easy  to  use,  and  delivers  the  results 
to  the  ijser  .n  a  •  '^•.■''v  manner.  TONE  3  manages  the  computer 
resources  so  '•'■jI  "ne  input,  processing  and  output  can  be 
oerform.ed  at  tne  nm.es  ana  at  a  rate  which  will  allow  users  to 
maximize  their  results, 

HIGHLIGHTS 

•  TSO  cornea'!^..-:-  ••^'minai  comimand  language, 

•  TSO  cc""r,':"       cc^r^and  orocessors 

•  Pcvertu:  ::a:3Sei  ed  'or 

•  Interactive  cogram  execution 


•  Dynamic  Allocation, 

•  Hot  internal  reader. 

•  Output  using  QMGR  I/O. 

•  User  swapping  eliminated. 
^'  •  TCAM  replaced. 

•  VTAM  support  available. 

•  Standard  file  structure  support. 

•  Designed  for  virtual  enviornment. 

•  Powerful  command  language. 

•  Enhanced  3270  support  package. 

TSO   COMPATIBLE   TERMINAL   COMMAND  LANGUAGE: 

The  TONE  3  terminal  commands  are  compatible  with  IBM  MVS 
R3.0  TSO.  A  terminal  user  with  TSO  experience  will  find  that 
experience  applicable  to  the  TONE  3  environment.  The  recom- 
mended manual  for  terminal  users  is  the  0S/VS2  TSO  Com- 
mand Language  Reference  —  VS2  Release  3.0  (GC28-0646). 
This  manual  may  be  supplemented  by  the  TONE  3  user  guide. 

TSO  COMPATIBLE  COMMAND  PROCESSORS:  TONE  3 
includes  several  enhancements  to  the  VSl  operating  system. 
Through  these  enhancements  and  the  management  facilities  of 
TONE  3,  most  command  processors  (CP's)  written  for  execu- 
tion under  TSO  will  operate  without  modification  under  the 
control  of  the  TONE  3  system. 

VERSATILE  DATASET  EDITOR:  Dataset  editing  facilities  sup- 
port all  major  languages  which  are  in  use  today.  Each  of  these 
dataset  types  are  recognized  by  name,  appropriate  fields  are 
dedicated  to  line  numbering,  convenient  tab  locations  are 
defined  by  default,  record  formats  are  assumed  for  new  data- 
sets,  and  appropriate  character  modifications  are  automatic 
(lower  case  converted  to  upper  case).  The  following  language 
dataset  types  are  supported: 

Cobol; 

Fortran, 

PL1; 

Assembler; 
VS  Basic; 

Other  data  set  types  which  are  supported  are; 

DATA  —  for  upper  case  data, 

TEXT  —  for  upper  and  lower  case  data. 

CNTL  —  for  job  control  streams. 

The  editor  uses  a  number  of  the  facilities  provided  by  the 
TONE  3  system.  When  the  user  issues  the  EDIT  command, 
the  Editor  dynamically  allocates  the  file  specified  by  the  user; 
creates  .a  copy  of  the  specified  file  in  a  dynamically  allocated 
work  file;  and  invokes  subcommand  processors  to  perform 
required  functions  on  the  work  file. 

SUPPORTED  SUBFUNCTIONS  INCLUDE  BUT  ARE  NOT 
LIMITED  TO; 

Input      —  Places  the  system  in  a  status  to  accept  data  into 
the  work  file. 

Verify     —  Displays  at  the  terminal  the  line  or  lines  most 
recently  acted  upon. 

Find       —  For  examining  each  record  (line)  m  the  work  file 
for  a  specified  sequence  of  characters. 

Change  —  Modifies   a    sequence   of   characters  (character 
string)  in  a  line  or  range  o1  lines 

Delete    —  Removes  one  or  more  recor'ds  f^om  the  work  tile 

List        —  Displays  one  or  more  lines  of  the  work  file  at  the 
terminal. 

Move     —  Moves  one  or  more  records  that  already  exist  in 
the  worK  file. 


SUBFUNCTIONS  (Cont'd) 


Copy  —  Copies  one  or  more  records  that  already  exist  in 
the  work  file. 

Help      —  Obtains  the  syntax  and  functions  of  subcomnnands. 

Subnnit  —  Submits  one  or  more  batch  jobs  for  conventional 
processing.  Jobs  are  entered  directly  into  the  JES 
job  queue. 

Save  —  Retains  the  edited  dataset  as  a  permanent  cat- 
aloged dataset.  The  results  of  the  edit  may  be 
saved  with  a  new  dataset  name  or  replace  the 
dataset  originally  edited. 

INTERACTIVE  PROGRAM  EXECUTION:  Most  programs  which 
are  executable  in  batch  may  be  called  into  execution  under 
the.  user's  terminal  function  and  either  made  to  interact  with 
the  user  or  simply  run  to  completion  with  user  notification. 
Normal  batch  data  facilities  are  available  to  programs  execut- 
ing interactively;  however,  interactive  programs  may  receive 
data  directly  from  the  users  terminal,  and  the  output  from  the 
program  may  be  displayed  directly  on  the  terminal. 

DYNAMIC  ALLOCATION:  The  dynamic  allocation  facility 
allows  periodic  aquisition  and  release  of  resources  necessary 
to  simulate  batch  execution  in  the  foreground.  It  is  as  though 
the  execution  JCL  for  this  foreground  job  (the  terminal 
session)  had  been  changed  from  time  to  time,  during  the 
session,  but  without  the  imposition  of  the  initiation/termination 
overhead. 

Dynamic  allocation  provides  access  to  files  which  may 
have  been  previously  created  in  batch  mode,  (such  as 
SYSI  .LINKLIB).  or  created  in  another  terminal  session.  The 
files  may  be  new  files  for  the  user;  such  as  library  datasets  of 
JCL,  Assembler.  Cobol.  etc.  Files  such  as  SYSIN,  SYSOUT,  - 
and  SYSPRINT  may  be  directed  to  the  terminal  for  interactive 
execution. 

Dynamic  allocation  is  also  used  by  TONE  3  to  aquire  access  to 
terminals.  Allocation  of  the  terminals  occurs  at  the  time  they 
are  started:  they  are  released  when  they  are  no  longer  in  use. 

HOT  INTERNAL  READER:  Jobs  submitted  for  batch  execution 
are  submitted  directly  to  the  JES  input  queues.  No  intermediate 
files  are  used.  The  hot  internal  reader  (TONERDR)  is  available 
to  users  for  job  subm.ittal  by  other  batch  jobs  if  desired. 

OUTPUT  USING  QMGR  I/O:  Upon  completion  of  a  submitted 
job  the  terminal  user  can  review  the  spooled  output.  Through 
the  use  of  the  output  command  the  user  may  read  the  SYS- 
MSG  dataset  and  all  SYSOUT  files  directly  from  the  VS1  out- 
put queue.  The  output  command  interfaces  directly  with  JES 
using  queue  manager  I/O  commands.  At  any  time  the  user 
may  either; 

1.  Requeue  the  output  tor  later  review. 

2.  Requeue  the  output  into  a  print  class  destined  for  hard 
copy  printing, 

3.  Save  the  outout  into  an  OS  sequential  or  partitioned 
dataset. 

4     Delete  all  soooled  outout 

USER  SWAPPING  ELIfvllN ATED:  MVT  and  SVS  TSO  use  a 

■ocnv.iqu-i  called  user  ':...vdnDim  The  original  purpose  of  user 
:.vaDDing  7;as  :g  orovide  effective  fTiemory  management 
''-J-  SYSTEM.'360  comouters  V/henever  a  users  'time  slice'  was 
'-jii^ted  -.vnether  or  not  r~;s  function  was  completed,  the 
-  --rs  ccce  '.v.-is  .vnt'en  ,'^;o  a  swap  fiie,  and  another  users 
r-ao  .inc  e/ec'jtej.  after  ail  oiher  users  received 
^-cccr:„n,:v  :o  execute  their  •■me  s:;ce'  tne  first  users 
-'Ce  wcs  re*'' o^ea.  This  user  swapping  imposed  tremiencous 
iysiem  overneaa. 


The  virtual  memory  management  design  of  the  VS1  operating 
system  is  far  more  efficient.  VSI  memory  utilization  is  based 
on  a  least  recently  used  algorithm.  This  method  has  proved  to 
\  be  very  efficient  for  interactive  processes.  TONE  3  uses  the 
VSI  memory  management  in  place  of  user  swapping. 

TCAM  REPLACED:  All  IBfvl  versions  of  TSO  use  the  tele- 
communications access  method  (TCAM)  for  communication 
with  terminals.  TCAM  management  techniques  for  message 
handling  use  significant  computer  resources,  with  limited 
benefits  for  the  time  sharing  user.  TONE  3  utilizes  basic 
telecommunications  access  method  (BTAM).  BTAM  uses  less 
memory,  requires  less  processing  time,  and  is  considerably 
more  reliable. 

VTAM  SUPPORT  AVAILABLE:  TONE  3  provides  an  inter- 
face to  the  virtual  telecommunications  access  method  (VTAM). 
User  terminals  may  interface  with  multiple  TONE  regions, 
and/or  other  applications  through  the  use  of  VTAM. 

STANDARD  FILE  SUPPORT:  All  of  the  datasets  used  by 
TONE  3  have  standard  OS  file  structures.  TONE  3  users  may 
utilize  sequential  or  partitioned  datasets  of  any  record  format, 
logical  record  length,  or  block  size.  Interactive  programs  can 
gain  the  use  of  previously  allocated  virtual  storage  access 
method  (VSAM)  datasets.  VSAM  datasets  may  not,  however,  be 
created  through  the  use  of  the  TONE  3  allocate  functions; 
allocation  (creation)  of  these  files  must  be  directed  through  an 
interactive  execution  of  the  IDCAMS  utility. 

DESIGNED  FOR  VIRTUAL  ENVIRONMENT:  A  primary 
objective  in  the  design  of  TONE  3  was  to  effectively 
utilize  the  functions  df  the  VSI  operating  system.  The  TONE  3_ 
system  is  entirely  virtual  and  does  no  page  fixing  of  its 
own.  The  only  page  fixing  is  done  by  lOS  for  data  buffers. 
TONE  3  code  is  reentrant,  and  all  code  is  placed  in  link  pack 
to  minimize  the  use  of  both  virtual  and  real  storage.  TONE  3 
may  be  operated  concurrently  with  the  VS1  time  slicing  and 
dynamic  dispatching  algorithms.  These  can  be  used  in  the  VSI 
system  at  the  selection  of  the  systems  programmer  to 
distribute  the  resources  among  the  various  users. 

EXTENSIVE  COMMAND  LANGUAGE:  TONE  3  utilizes  the 
TSO  command  procedure  (CLIST)  format.  These  CLISTS  are  a 
prearranged  executable  sequence  of  TONE  3  commands,  sub- 
commands, and  control  information.  CLISTS  reside  in  standard 
format  datasets.  A  CLIST  may  be  invoked  by  issuing  the  EXEC 
command  or  the  EXEC  subcommand  of  EDIT. 

ENHANCED  3270  SUPPORT  PACKAGE 

•  Full  screen  reads  and  writes  — 

Full  screen  mode  reads  and  writes  are  supported,  util- 
izing all  1920  characters  of  the  3277  MOD  02  or 
compatible  device. 

•  Windowing  — 

The  3270  screen  buffers  contain  133  character  lines.  The 
windowing  function  is  activated  through  the  use  of  a  pro- 
gram function  key  (PFK)  defined  by  the  user  The 
interrupt  directs  the  screen  of  the  3277  to  display  any 
selected  80  characters  from  the  possible  133  Tne  de- 
faults are  1-80  and  alternately  54-133,  Using  this  window- 
ing it  is  convenient  to  review  data,  such  as  some 
SYSOUT,  wtuch  is  wider  than  the  physical  terminal 
screen 

•  Physical  Tab  — 

Through  the  PFK  functions  the  user  can  define  a  pnysical 
tao.  Execution  of  this  ;^nct:on  wiii  cause  the  curse  to 
skip  along  the  input  line  filling  m  the  shipped  area 
wiin  blanks. 


•  Logical  Tab  — 

The  user  may  define  a  character  to  be  used  as  a  logical 
tab  character.  The  3270  support  will  replace  the  logical 
tab  character  in  the  input  line  so  that  the  receiver  of  the 
data  line  will  recognize  the  real  tab  (x'15')  character. 

•  Programmable  PA/PF  Keys  — 

TONE  3  supports  programmable  PA/PF  keys.  The  user 
can  retrieve  the  PA/PF  key  definitions  and  modify  any  of 
the  15  possible  keys  for  special  functions,  or  to  input 
data  to  the  system.  Any  PF  function  can  be  made  to  be 
interactive,  the  data  line  is  inserted  in  the  input  area  of 
the  3277  and  the  cursor  is  placed  in  the  line  as  directed 
by  the  user.  The  modified  definitions  may  be  saved  for 
later  recall  by  member  name.  The  functions  are  executed 
when  the  PA/PF  keys  are  depressed,  or  when  the 
PA/PF  key  simulation  is  executed. 

•  PA/PF  Key  Simulation  — 

For  those  terminals  without  a  full  set  of  PA  or  PF  keys, 
TONE  3  provides  a  PA/PF  key  simulation  method  This 
function  enables  the  terminal  user  to  indicate  the  PA/PF 
function  desired,  and  the  appropriate  data,  if  any,  to 
be  used  in  the  PA/PF  function.  _  , 

•  Instant  interrupt  — 

Most  TONE  3  functions  are  instantly  interruptable  from 
the  3277.  This  is  in  sharp  contrast  to  TCAM  which  " 
required  the  users  to  specify  a  time  interval,  after 
v/hich  the  system  must  interrogate  the  terminal  for  per- 
mission-to  continue.  The  3277  is  always  in  ready  status 
when  using  TONE  3. 

»    Line  Retrieval  — 

The  terminal  user  may,  using  the  line  retrieval  functions, 
retrieve  a  previously  displayed  line  or  part  of  a  line.  This 
is  done  by  moving  the  cursor  to  the  beginning  of  the 
data  desired,  and  depressing  the  enter  key.  .  :  , 

•  Screen  Format  — 

The  TONE  3  system  displays  at  all  times,  (except  when  in 
full  screen  mode),  a  format  which  conveniently  contains: 
the  time  of  day;  the  time  since  logon;  the  total  CPU 
time  used;  the  identity  of  the  current  user;  and  the 
command  in  execution. 

COMPONENTS 

The  TONE  3  system  is  comprised  of  the  following  major 
components. 

•  TONE  3  VS1  enhancements 

•Dynamic  allocation 

•CPU  timing  for  subtasks  .  .  ,  ' 

•  Memory  Subpool  Management 
•CVT  extention  _  , 

•TSO  services 

•  TONE  3  partition  code 

•TONE  3  region  controller 

•TONE  3/TSO  initiator 

•All  BTAM  console  handlers 

•Console/Program  interface 

•MVS  (VS2  R3.0)  TSO  to  function  under  VSI 

•Edit 

•Allocate  •Submit 
•Free  •Output 

•Attribute  •Logon/Logoff 
•Call  •List/ds/cat 

SYSTEM  CONFIGURATION 
•    Virtual  Storage 

The  virtual  storage  requirement  is  dependent  upon  the 
number  of  active  TONE  3  partitions  and  the  modules 
selected  for  UrM  pack  Aoproximately  one  megabyte  in 
iirik  cack  ana  a  one  megabyte  partition  for  each  twelve 
started  terminals  is  necessary  Additional  terminals 
rec'jire  only  partition  space. 


•  Real  Storage 

The  real  storage  utilization  is  dependent  upon  the  activity 
of  the  system,  the  relative  priority  of  the  TONE  3  parti- 
tions, and  the  nature  and  frequency  of  user  commands. 
It  is  suggested  that  the  user  monitor  memory  utilization 
during  the  trial  period  to  determine  the  nature  of  \h\sf 
requirement. 

•  Partitions 

TONE  3  supports  multiple  users  in  all  TONE  3  partitions. 
The  number  of  users  is  limited  by  the  VSl  limitation  of 
255  "DD"  statements  per  partition.  Approximately  ten  to 
twelve  started  terminals  are  possible  for  each  TONE  3 
partition. 

•  DASD  Storage 

The  TONE  3  code  will  require  approximately  one  mega- 
byte of  online  DASD  storage.  Approximately  ten  to  twelve 
megabytes  may  be  offline  at  times  other  than  installation. 

•  Central  Processing  Units 

Svstem/370  Models  135  and  up,  433X,  434X,  303X,  and 
other  announced  IBM  or  compatible  machines  supporting 
VSI  operating  systems. 

•  Direct  Access  Storage 

2314  direct  access  storage  facility,  (models  1 ,  A  and  B)  and 
2844  auxiliary  storage  control; 
7        2319  disk  storage,  (models  A  and  B); 
.      3330  series  disk  storage,  all  models; 

3340  direct  access  storage  facility,  all  models; 

3350  direct  access  facility,  all  models; 

2305  fixed  head  storage  facility,  models  1  and  2. 

•  Terminals 
Master  console; 
3270  Model  2; 
ASC  I  I  devices; 

2740,  models  1  and  2  (station  control  and  checking  are 

necessary); 
2741 

3278  -  all  models  including  132  character  model  5 
EDUCATION 

The  dates,  times  and  locations  of  TONE  3  seminars  and  work- 
shops will  be  selected  to  best  suit  the  needs  of  TSC  customers. 

TECHNICAL  SUPPORT 

Programming  support,  enhancements,  and  technical  assistance 
are  included  for  the  term  of  the  contract.  Thereafter  support 
will  be  available  from  TSC  at  a  nominal  monthly  charge. 

FREE  TRIAL  PERIOD 

The  user  will  have  thirty  days  to  evaluate  the  use  of  the  TONE  3 
system.  If  at  any  time  during  this  period  the  user  decides  not  to 
continue,  they  may  return  the  software  without  further  ob- 
ligation. 

INSTALLATION  AND  TRAINING 

Installation  by  Tone  Software  Corporation  personnel  is  recom-  j 
mended  TSC's  installation  charge  includes  a  one  day  class  in 
the  use  of  the  TONE  3  facilities. 


Software  Corp.  I 

1 

(714)991-9460  ! 
1735  SO.  BROOKHURST  j 
ANAHEIM,  CA  92804  j 
TELEX:  181592 
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CAPABILITY 

TONE  4  enables  MVS  installations  to  extend  the  following 
capabilities  to  the  terminal  user. 

•  Run  multiple  users  in  a  single  address  space. 

•  133  character  logical  screen  with  left  and  right  scrolling. 

•  User  defined  program  function  keys. 

•  Instant  interrupt. 

OVERVIEW 

The  system  is  designed  to  meet  the  following  goals: 

•  To  improve  the  effectiveness  of  the  users  computer 
system. 

•  To  make  this  capability  compatible  with  IBM  TSO. 

•  To  eliminate  the  overhead  associated  with  TCAM. 

•  To  eliminate  the  overhead  associated  with  user 
swapping. 

•  To  minimize  the  scheduling/operator  interaction  with  the 
terminal  user. 

•  To  minimize  the  effects  of  the  interactive  time  sharing 
facilities  on  computer  resources. 


USEABILITY:  TONE  4  capabilities  are  provided  in  a  format 
which  is  identical  to  the  IBM  time  sharing  option  (TSO);  this 
language  has  become  the  standard  for  IBM  computer  time 
sharing  users.  Significant  enhancements  to  useability  have 
been  provided  for  the  users  of  3270  type  terminals  through 
the  TONE  4  3270  support  package. 

EFFICIENCY:  The  implementation  of  most  time  sharing  sys- 
tems has  added  significant  overhead  for  the  purpose  of  man- 
aging the  telecommunications  network  and  the  interaction 
of  multiple  online  users.  The  IBM  MVT/SVS/MVS  systems 
include  these  components;  they  are  telecommunications 
access  method  (TCAM),  and  user  swapping.  TONE  4  manages 
most  terminal  networks  using  basic  telecommunications 
access  method  (BTAM),  a  simpler  and  more  efficient  telecom- 
munications monitor.  TONE  4  throughput  is  enhanced  by  its 
use  of  MVS  multitasking  and  virtual  memory  management, 
which  eliminate  the  requirement  for  user  swapping. 

EFFECTIVENESS:  The  computer  system  is  most  effective 
when  it  is  available  to  the  user,  easy  to  use,  and  delivers  the 
results  to  the  user  in  a  timely  manner.  TONE  4  manages  the 
computer  resources  so  that  the  input,  processing  and  output 
can  be  performed  at  a  rate  which  will  allow  users  to  maximize 
their  results. 

HIGHLIGHTS 

•  User  swapping  eliminated. 

•  TCAM  replaced. 

•  Enhanced  3270  support  package. 

•  VTAM  support  available. 

•  Designed  for  virtual  environment. 

•  Standard  file  structure  support. 

•  Versatile  TSO  Data  Set  Editor. 

•  TSO  Interactive  Program  Execution. 

•  Output  using  QMGR  I/O, 

•  TSO  terminal  command  language. 

•  TSO  command  processors. 

•  Full  screen  edit  option  availability. 

USER  SWAPPING  ELIMINATED:  MVT,  SVS  and  MVS  TSO  use 

a  technique  called  user  5v;apping.  The  original  purpose  of 
user  S'.vapping  was  to  provide  effective  memory  management 
for  SYSTEM/360  comouters.  Whenever  a  user's  'time  slice' 
was  satisfied,  whether  or  not  his  function  was  completed,  the 


user's  code  was  written  into  a  swap  file,  and  another  user's 
code  read  in  and  executed;  after  all  other  users  received  an 
opportunity  to  execute  for  their  'time  slice'  the  first  users 
code  was  retrieved.  This  user  swapping  imposed  tremendous  i 
system  overhead. 

The  virtual  memory  management  design  of  the  MVS 
operating  system  is  far  more  efficient.  MVS  memory 
utilization  is  based  on  a  least  recently  used  algorithm.  This 
V  method  has  proved  to  be  very  efficient  for  interactive 
processes.  TONE  4  uses  the  MVS  memory  management  in 
place  of  user  swapping. 

TCAM  REPLACED:  All  IBM  versions  of  TSO  use  the  teleconn- 
munications  access  method  (TCAM)  for  communication  with 
terminals.  TCAM  management  techniques  for  message 
handling  use  significant  computer  resources,  with  limited 
benefits  for  the  time  sharing  user.  TONE  4  utilizes  basic  tele- 
communications access  method  (BTAM).  BTAM  uses  less 
memory,  requires  less  processing  time,  and  is  considerably 
more  reliable. 

ENHANCED  3270  SUPPORT  PACKAGE 

•  Full  screen  reads  and  writes  — 

Full  screen  mode  reads  and  writes  are  supported,  utiliz- 
ing all  1920  characters  of  the  3277  MOD  02  or  compatible 
device. 

•  Windowing  — 

The  3270  screen  buffers  contain  133  characters  per  line. 
The  windowing  function  is  activated  through  the  use  of  a 
program  function  key  (PFK)  defined  by  the  user.  The  in- 
terrupt directs  the  screen  of  the  3277  to  display  any 
selected  80  characters  from  the  possible  133.  The  de- 
faults are  1-80  and  alternately  54-133.  Using  this  window- 
ing it  is  convenient  to  review  data,  such  as  SYSOUT, 
which  is  wider  than  the  physical  terminal  screen. 

•  Physical  Tab  — 

Through  the  PFK  functions  the  user  can  define  a  physi- 
cal tab.  Execution  of  this  function  will  cause  the  cursor 
to  skip  along  the  input  line  filling  in  the  skipped  area 
with  blanks. 

•  Logical  Tab  — 

The  user  may  define  a  character  to  be  used  as  a  logical 
tab  character.  The  3270  support  will  replace  the  logical  tab 
character  in  the  input  line  so  that  the  receiver  of  the  data 
line  will  recognize  the  real  tab  (x'15')  character. 

•  Programmable  PA/PF  Keys  — 

TONE  4  supports  programmable  PA/PF  keys.  The  user 
can  retrieve  the  PA/PF  key  definitions  and  modify  any  of 
the  15  possible  keys  to  effectuate  special  functions,  orto 
input  data  to  the  system.  Any  PF  function  can  be  made  to 
be  interactive;  the  data  line  is  inserted  in  the  input  area  of 
the  3277  and  the  cursor  is  placed  in  the  line  as  directed 
by  the  user.  The  modified  definitions  may  be  saved  for 
later  recall  by  member  name.  The  functions  are  executed 
when  the  PA/PF  keys  are  depressed,  or  when  the  PA/PF 
key  simulation  is  executed. 

•  PA/PF  Key  Simulation  — 

For  those  terminals  without  a  full  set  of  PA  or  PF  keys, 
TONE  4  provides  a  PA/PF  key  simulation  method.  This 
function  enables  the  terminal  user  to  indicate  the  PA/PF 
function  desired,  and  the  appropriate  data,  if  any,  to  be 
used  in  the  PA/PF  function. 

•  Instant  Interrupt  — 

Most  TONE  4  functions  are  instantly  interruptable  from 
the  3277.  This  is  in  sharp  contrast  to  TCAM  which 
required  the  users  to  specify  a  time  interval,  after  which 
the  system  must  interrogate  the  terminal  for  permission 
to  continue.  The  3277  is  always  in  ready  status  when 
using  TONE  4. 
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•  Line  Retrieval  — 

The  terminal  user  may,  through  the  facility  of  the  line 
retrieval  functions,  retrieve,  and  place  in  the  input  area,  a 
previously  displayed  line  or  part  of  a  line.  This  is  done  by 
moving  the  cursor  to  the  beginning  of  the  data  desired, 
and  depressing  the  enter  key. 

•  Screen  Format  — 

The  TONE  4  system  displays  at  all  times  (except  when  in 
full  screen  mode),  a  format  which  conveniently  contains: 
the  time  of  day;  the  time  since  logon;  the  total  CPU  time 
used;  the  identity  of  the  current  user;  and  the  pri- 
mary command  name. 


.'AM  SUPPORT  AVAILABLE:  TONE  4  provides  an  interface 
the  virtual  telecommunications  access  method  (VTAM). 
jer  terminals  may  interface  with  multiple  TONE  regions, 
id/or  other  applications  through  the  use  of  VTAM. 


ESIGNED  FOR  VIRTUAL  ENVIRONMENT:  A  primary  objec- 
'e  in  the  design  of  TONE  4  was  to  effectively  utilize  the 
notions  of  the  MVS  operating  system.  The  TONE  4  system 
entirely  virtual  and  does  no  page  fixing  of  its  own.  The  only 
ige  fixing  is  done  by  lOS  for  data  buffers.  TONE  4  code  is  re- 
itrant;  code  placed  in  link  pack  minimizes  the  use  of  both 
tual  and  real  storage. 


;rANDARD  FILE  STRUCTURE  SUPPORT:  All  of  the  datasets 
;ed  by  TONE  4  have  standard  OS  file  structures.  TONE  4 
i;ers  may  utilize  sequential  or  partitioned  datasets  of  any 
cord  format,  logical  record  length,  or  block  size.  Interactive 
lograms  can  gain  the  use  of  previously  allocated  virtual  stor- 
iie  access  method  (VSAM)  datasets.  VSAM  datasets  may 
l)t,  however,  be  created  through  the  use  of  the  TONE  4  allo- 
I  te  functions;  allocation  (creation)  of  these  files  must  be 
i|rected  through  an  interactive  execution  of  the  IDCAMS 
I  ility. 


IjERSATILE  TSO  DATASET  EDITOR:  Dataset  editing  facilities 
'^ipport  all  major  languages  which  are  in  use  today.  Each  of 
ese  dataset  types  are  recognized  by  name,  appropriate 
|jlds  are  dedicated  to  line  numbering,  convenient  tab 
Ications  are  defined  by  default,  record  formats  are  assumed 
'r  new  datasets,  and  appropriate  character  modifications  are 
i  itomatic  (lower  case  converted  to  upper  case).  The  following 
'nguage  dataset  types  are  supported: 

COBOL; 

FORTRAN; 

PL1; 

ASM; 

VS  BASIC. 

i 

'Ither  data  set  types  which  are  supported  are: 
\TA  —  for  upper  case  data. 
:XT  —  for  upper  and  lower  case  data. 
JTL  —  for  job  control  streams.  - 

IJPPORTED  SUBFUNCTIONS  INCLUDE,  BUT  ARE  NOT 
MIXED  TO: 

put      —  Places  the  system  m  a  status  to  accept  data  into 
the  work  tile. 


Verify  —  Displays  at  the  terminal  the  line  or  lines  most 
recently  acted  upon. 

Find  —  For  examining  each  record  (line)  in  the  work  file 
for  a  specified  sequence  of  characters. 

Change  —  Modifies  a  sequence  of  characters  (character 
string)  in  a  line  or  range  of  lines. 

Delete    —  Removes  one  or  more  records  from  the  work  file. 

List  —  Displays  one  or  more  lines  of  the  work  file  at  the 
terminal. 

Move  —  Moves  one  or  more  records  that  already  exist  in 
the  work  file. 

Copy  —  Copies  one  or  more  records  that  already  exist  in 
the  work  file. 

Help  —  Obtains  the  syntax  and  functions  of  subcom- 
mands. 

Submit  —  Submits  one  or  more  batch  jobs  for  conventional 
processing.  Jobs  are  entered  directly  into  the 
JES  job  queue. 

Save  —  Retains  the  edited  dataset  as  a  permanent  cata- 
loged dataset.  The  results  of  the  edit  may  be 
saved  with  a  new  dataset  name  or  replaced  with 
the  dataset  originally  edited. 


TSO  INTERACTIVE  PROGRAM  EXECUTION:  Most  programs 
which  are  executable  in  batch  may  be  called  into  execution 
under  the  user's  terminal  function  and  either  made  to  interact 
with  the  user  or  simply  run  to  completion  with  user  notifica- 
tion. Normal  batch  data  facilities  are  available  to  programs 
executing  interactively;  interactive  programs  however,  may 
receive  data  directly  from  the  users  terminal,  and  the  output 
from  the  program  may  be  displayed  directly  on  the  terminal. 

TSO  OUTPUT  USING  QMGR  I/O:  Upon  completion  of  a  sub- 
mitted job  the  terminal  user  can  review  the  spooled  output. 
Through  the  use  of  the  output  command  the  user  may  read 
the  SYSMSG  dataset  and  all  SYSOUT  files  directly  from  the 
MVS  output  queue.  The  output  command  interfaces  directly 
with  JES  using  queue  manager  I/O  commands.  At  any  time 
the  user  may  either: 

1.  Requeue  the  output  for  later  review. 

2.  Requeue  the  output  into  a  print  class  destined  for  hard 
copy  printing. 

3.  Save  the  output  into  an  OS  sequential  or  partitioned 
dataset. 

4.  Delete  all  spooled  output. 

TSO  TERMINAL  COMMAND  LANGUAGE:  The  TONE  4  termi- 
nal commands  are  identical  with  IBM  MVS  R3.7  TSO.  A  termi- 
nal user  with  TSO  experience  will  find  that  experience  appli- 
cable to  the  TONE  4  environment.  The  recommended  manual 
for  terminal  users  is  the  0S/VS2  TSO  Command  Language 
Reference  —  VS2  Release  3.7  (GC28-0646).  This  manual  may 
be  supplemented  by  the  TONE  4  user  guide. 

TSO  COMMAND  PROCESSORS:  TONE  4  supports  TSO  com- 
mand processors.  Most  command  processors  (CP's)  written 
for  execution  under  TSO  will  operate  without  modification 
under  the  control  of  the  TONE  4  system. 

FULL  SCREEN  EDIT  OPTION  AVAILABILITY:  Separate  price 
option.  (Specification  available  upon  request.) 


SYSTEM  CONFIGURATION 

•  Virtual  Storage 

The  virtual  storage  requirement  is  dependent  upon  the 
number  of  active  TONE  4  partitions  and  the  modules 
selected  for  link  pack  (approximately  one  megabyte  in 
link  pack  and  one  to  two  megabytes  in  each  address 
space).  Additional  terminals  require  only  address  space. 

•  Real  Storage 

The  real  storage  utilization  is  dependent  upon  the  activ- 
ity of  the  system,  the  relative  priority  of  the  TONE  4 
address  spaces,  and  the  nature  and  frequency  of  user 
commands.  It  is  suggested  that  the  user  monitor  memory 
utilization  during  the  trial  period  to  determine  the 
nature  of  this  requirement. 

•  Address  Spaces 

TONE  4  supports  multiple  users  in  each  MVS  address 
space.  The  number  of  users  is  theoretically  unlimited. 
Approximately  15  to  25  started  terminals  are  recom- 
mended for  each  TONE  4  partition. 

•  DASD  Storage 

The  TONE  4  code  vuill  require  approximately  one  mega- 
byte of  online  DASD  storage.  Approximately  ten  to 
twelve  megabytes  may  be  offline  at  times  other  than 
installation. 

•  Central  Processing  Units 

IBM  System/370  Models  158,  (models  1  and  3), 
165  II,  168  (models  1  and  3);  3032,  3033,  or  equiva- 
lents. 

•  Direct  Access  Storage 

IBM  3330  series  disk  storage,  all  models; 

IBM  3340  direct  access  storage  facility,  all  models; 

IBM  3350  direct  access  facility,  all  models; 

IBM  2305  fixed  head  storage  facility,  models  1  and  2. 

Equivalents  of  any  of  the  above  storage  devices. 

•  Terminals 

Master  console; 

3270  model  2;  '  , 

ASCII  devices:  ■ 

2740,  models  1  and  2  (station  control  and  checking  are 

necessary); 
2741. 

Equivalents  of  any  of  the  above  terminal  devices. 


PERFORMANCE 

Data  varies  depending  upon  CPU,  and  type  of  job  involved. 
The  resultant  graphs  depict  typical  response  times  for 
standard  TSO  and  TONE  4. 


CO 

a 
z 
o 
o 

LU 

cn 

LU 

LD 
UJ  T- 
(/)  - 

z:  o) 
O  ^ 

CL  S 

C/)  00 

cr 
uu 
O 
< 

DC 
LU 
> 
< 


50 


40 


30 


20 


10 


STi 

\NDARD  / 
TSO/ 

'"TONE  4 

0  10  20  30 

NUMBER  OF  TERMINAL  USERS 

EDUCATION 

The  dates,  times  and  locations  of  TONE  4  seminars  and  work- 
shops will  be  selected  to  best  suit  the  needs  of  TSC  cus- 
tomers. 

TECHNICAL  SUPPORT 

Programming  support,  enhancements,  and  technical  assis- 
tance are  included  for  the  term  of  the  contract.  Thereafter 
support  will  be  available  from  TSC  at  a  nominal  monthly 
charge. 

FREE  TRIAL  PERIOD 

The  user  will  have  thirty  days  to  evaluate  the  use  of  the 
TONE  4  system.  If  at  any  time  during  this  period  the  user 
decides  not  to  continue,  they  may  return  the  software  without 
further  obligation. 

INSTALLATION  AND  TRAINING 

Installation  by  Tone  Software  Corporation  personnel  is 
recommended.  TSC's  installation  includes  one  day  on  site 
training  in  the  use  of  TONE  4  capabilities. 


(714)  991-9460 
1124  N.  Gilbert  Anaheim,  Ca.  92801 


CAPABILITY 

DASD3336  is  designed  to  provide  complete 
security,  analysis  and  history  of  3336  Mod  1  and 
3336  Mod  11  disk  packs.  The  following  functions 
are  supported: 

1.  Overwrites  all  tracks,  whether  active  or  cur- 
rently assigned  alternates. 

2.  Lists  all  tracks  currently  assigned  alternates. 

3.  Attempts  reuse  of  an  original  track  if  currently 
assigned  an  alternate. 

4.  Completely  reformats  a  pack,  rewriting  all 
HA/RO's. 

OVERVIEW 

The  program  was  designed  to  meet  the  following 
goals: 

1.  To  provide  the  user  with  certainty  that  all  high- 
security  data  on  the  pack  has  been  destroyed. 

2.  To  enable  the  purchaser  of  3336  or  equivalent 
packs  to  fairly  and  impartially  evaluate  all  data 
areas  of  each  pack  submitted  for  aquisition. 

3.  To  provide  for  ongoing  monitoring  of  pack  per- 
formance. 

4.  To  provide  the  user  with  the  capability  to  im- 
prove performance  by  reusing  a  primary  track 
now  assigned  an  alternate,  if  the  primary  track 
is  now  able  to  accept  data. 

5.  To  reformat  a  currently  unusable  volume. 


Operator  Assistance 

During  analysis  operations  DASD3336  displays 
the  results  of  each  function  on  the  console  to 
enable  the  operator  to  monitor  the  progress  of  the 
analysis. 


List  Function 

The  list  option  allows  the  listing  of  alternate 
tracks  assigned  to  a  [jack.  This  option  may  be  run 
online  to  any  3330  Mod  1  or  Mod  1 1  while  the  pack 
IS  being  used  for  normal  operation. 


Retrieve  Function 

The  retrieve  option  attempts  to  reactivate  a 
primary  track  which  is  currently  assigned  an  alter- 
nate. DASD3335  reads  the  data  on  the  alternate 
and  attempts  to  rewrite  it  on  the  primary  track.  If 
this  is  successful,  the  primary  track  is  marked  as 
active.  This  option  must  be  run  with  the  drive  off- 
line to  0S/VS1. 

Format  Function 

The  format  option  provides  the  analysis  of  each 
track  of  a  3336  pack.  This  analysis  checks  each  bit 
cell  on  primary  and  alternate  tracks.  A  temporary 
VTOC  is  written  on  tracks  1  thru  5  with  a  label 
specified  by  the  user.  This  option  must  be  run 
with  the  drive  offline  to  0S/VS1.  This  function  pro- 
vides complete  destruction  of  all  data  currently  on 
the  volume. 

PERFORMANCE 

The  retrieval  and  format  functions  have  a  'passes' 
parameter.  Through  the  use  of  this  parameter  the 
user  may  specify  the  extent  of  the  analysis.  Each 
pass  requires  approximately  fifteen  (15)  minutes 
for  a  Mod  1  pack  and  thirty  (30)  minutes  for  a  Mod 
11  pack. 

HARDWARE/SOFTWARE  CONFIGURATION 

DASD3336  requires  a  370  CPU  with  a  minimum  of 
one  available  3330  type  drive.  Appropriate  370 
CPU's  include:  370/135,  370/138,  370/145,  370/148, 
370/155  II,  370/158  Mod  1  and  Mod  3,  370/165  II, 
370/168,  3031,  3031-MP,  3032,  3032-MP,  3033, 
3033-MP.  DASD3336  is  currently  supported  under 
0S/VS1  release  6.0  through  the  most  current 
release  of  0S/VS1. 

Technical  Support 

Programming  support,  enhancements,  and 
technical  assistance  are  included  for  the  initial 
term  of  the  contract.  Thereafter,  support  v/ill  be 
available  from  TSC  at  a  nominal  monthly  charge. 

Ordering  information  = 

DASD3336  with  its  associated  documentation  is 
currently  available.  Contact  TSC  to  order  the 
package. 


Tl  1P,  INTERACTIVE  LIBRARIAN  COMMAND  PROCESSOR 


OVERVIEW 

TLIB,  Interactive  LIBRARIAN  Command  Processor, 
provides  the  user  with  the  ability  to  fully  utilize  the 
resources  of  LIBRARIAN  when  operating  in  a  TONE 
or  TSO  environment.  The  user  may  store,  retrieve, 
copy  or  delete  datasets  interactively  using  a  free  form 
command  structure.  System  and  programmer  efficiency 
are  improved  through: 

A  reduced  requirement  for  disk  space  by  storing 
modules  not  currently  needed  on  the  LIBRARIAN 
master  file  in  a  compressed  format. 

Powerful  on-line  editing  facilities  available  through 
TONE  and  TSO  that  provide  several  functions  not 
available  with  the  LIBRARIAN  editor. 

Extensive  prompting  on  all  commands  which  greatly 
reduces  programmer  training  and  simplifies  the  use 
of  all  LIBRARIAN  functions. 

COMMAND  FUNCTIONS 

TLIB  has  seven  basic  commands  which  provide  a  com- 
plete interface  between  the  LIBRARIAN  and  TONE/ 
TSO,  enabling  the  user  to  have  complete  and  flexible 
access  to  all  LIBRARIAN  functions.  These  commands 
include : 

LIBGET  enables  a  user  to  retrieve  information  from 
the  LIBRARIAN  master  file.  The  selected  module  is 
assigned  to  a  dynamically  allocated  standard  format 
VS  data  set  in  expanded  form  and  immediately 
available  for  review  or  subsequent  editing  using  the 
powerful  TONE/TSO  edit  capabilities. 

LIBSAVE  enables  terrninal  users  to  add  or  replace 
modules  on  the  LIBRARIAN  master  file.  During  an 

ADD  operation,  prompting  is  provided  for  descrip- 
tion and  lafiguage  parameters. 

LIBEDIT  allows  the  terminal  user  to  manipulate 
botli  the  column  and  sequence  number  positioning 
of  data  stored  in  a  LIBRARIAN  module.  Accuracy 
is  easily  examined  using  the  LIB  LOOK  function. 

LI3FILL  enables  the  operator  to  "gang  punch"  data 
into  specified  LIBRARIAN  modules. 


LIBDLM  deletes  a  module  from  the  master  file. 

LIBRENME  allows  the  user  to  rename  a  specified 
LIBRARIAN  module. 

LIBLOOK  is  a  utility  command  cluster  providing 
the  terminal  user  with  extensive  access  to  stored 
materials.  Five  options  include: 

LIBLOOK  INDEX  displays  a  full  index  of  all  mod- 
ules available  on  the  Librarian  master  file. 

LIBLOOK  INDEX(XXXXX)  displays  a  complete 
index  of  modules  by  programmer  ID. 

LIBLOOK  LISTH  displays  records  associated  with 
the  desired  module  as  well  as  control  information 
specifically  pertaining  to  that  module. 

LIBLOOK  LIST  allows  the  user  to  access  the  con- 
trol information  available  with  the  LIBLOOK 
LISTH  command  and  additionally  provides  a  com- 
plete list  of  the  module  itself. 

LIBLOOK  PUNCH  command  provides  the  user 
with  access  to  data  sets  by  using  the  utility  or 
punch  option.  It  allows  modules  containing 
INC's  to  be  retrieved  in  nonexpanded  form. 

PROGRAMMING  SYSTEMS 

TLIB  is  supported  under  current  releases  of  TONE  3, 
TONE  4  MVS  and  MVS  TSO. 

TECHNICAL  SUPPORT 

Programming  support,  enhancements,  and  technical 
assistance  are  provided  for  the  term  of  the  initial  con- 
tract. Thereafter,  support  will  be  available  from  Tone 
Software  Corporation  at  a  nominal  charge. 

INSTALLATION 

While  it  is  recommended  that  the  customer  install 
TLIB,  installation  is  available  from  Tone  Software 
Corporation  on  a  time  and  expenses  basis. 

TRIAL  PERIOD 

Tone  Software  Corporation  offers  the  customer  30 
days  to  evaluate  TLIB  software  and  associated  docu- 
mentation free  of  charge  and  without  further  obli- 
gation. 


VS1  DYNA^ilSC  ALL0CAT30H  OF  SYSOUT 


CAPABILITY 

PHASOR  provides  an  0S/VS1  user  with  the  ability 
to  dynamicaily  allocate  and  release  SYSOUT  datasets 
for  early  printing.  The  function  is  similar  to  the 
DYNALOC  feature  offered  in  MVS  with  a  number 
of  extensions. 

OVERVIEW 
Long-Running  Tasks 

Long-running  tasks  such  as  TP  monitors  need  not  be 
terminated  to  print  status  reports  or  dumps.  These 
datasets  may  be  created  dynamically  and  a  facility 
added  to  the  program  to  release  the  SYSOUT  on 
command. 

Exception  Reports 

Long-running  application  programs  may  release 
exception  reports  as  soon  as  they  are  available.  The 
exception  reports  may  be  examined  while  the  applica- 
tion itself  is  still  processing. 

Dynamic  Class  and  Destination 

User  programs  with  PHASOR  may  specify,  at  execu- 
tion time,  for  dynamic  SYSOUT  datasets: 

output  class  jobname 

destination  user  ID  output  writer 

number  of  copies  accounting  info 

output  priority  form  type 

Spool  Efficiency 

VS/1  spool  space  allocated  for  a  job  is  not  freed  until 
dll  SYSOUT  generated  by  the  job  has  been  printed. 
Tliis  characteristic  may  create  severe  problems  in  a 
RES  environment.  Suppose,  for  example,  the  user 
has  a  job  which  creates  100,000  lines  for  DEST  'A'  and 
10  lines  for  DEST  'B'.  Subsequently,  user  'A'  prints 
the  100,000  lines;  until  user  'B'  prints  the  10  lines, 
all  of  the  spool  space  for  the  job  will  remain  allocated. 
PHASOR  dynamic  SYSOUT  datasets  are  viewed  by 
0S/VS1  as  independent  jobs.  Spool  space  for  each 
dynamic  SYSOUT  dataset  is  released  as  soon  as  print- 
inrj  is  complete  for  that  dataset. 

INSTALLATION 

PHASOR  is  u'Mded  to  the  operatinf]  system  as  a  type 
three  or  type  tour  SVC.  Mo  other  modifications  to 
^h.e  oporatinq  system  are  reciuirerl. 


IMPLEMENTATION 

The  JCL/program  changes  which  are  required  to  make 
use  of  PHASOR  are: 


1.  The  DD  SYSOUT  =  X  keyword  for  SYSOUT 
datasets,  which  are  being  changed  to  PHASOR 
dynamic  SYSOUT  datasets,  must  be  replaced 
with  DD  DYNAM  or  DD  DUMMY  parameters. 

2.  Prior  to  opening  a  PHASOR  dynamic  SYSOUT 
dataset,  the  user  must  issue  a  call  to  the  PHASOR 
SVC. 

3.  To  release  the  PHASOR  dynamic  SYSOUT  dataset, 
the  user  must  issue  another  call  to  the  PHASOR 
SVC.  The  user  may,  at  this  time,  specify  CLASS, 
DEST,  COPIES,  etc.  for  this  dataset.  The  dataset 
need  not  be  closed  to  release  it  for  processing; 
however,  it  should  be  closed  the  last  time  this 
call  is  issued  for  any  given  dataset. 

4.  If  for  any  reason  the  user  wishes  to  revert  to 
conventional  SYSOUT  processing,  the  user  must 
replace  the  DYNAM  or  DUMMY  parameter  with 
the  standard  SYSOUT  =  X  keyword.  No  program 
modifications  would  be  required  at  that  time. 

PROGRAMMING  SYSTEMS 

PHASOR  is  currently  supported  under  0S/VS1  release 
6.0  through  the  most  current  release. 


TECHNICAL  SUPPORT 

Programming  support,  enhancements  and  technical 
assistance  are  included  in  the  lease  price.  Under  a  Fully 
Paid  License,  support  is  included  at  no  charge  for  the 
first  year,  and  available  for  a  nominal  fee  thereafter. 


TRIAL  PERIOD 

TONE  SOFTWARE  CORPORATION  offers  the 
customer  a  30-day  trial  period  to  evaluate  FSM.  If 
at  any  time  during  this  trial  period  the  user  decides 
not  to  continue  the  evaluation,  the  system  and 
documentation  may  be  returned  without  obligation. 


i^TSHSVSTES^  SPOOL  Pg^OOSSSOB 


The  Intersystem  Spool  Processor  (ISP)  is  design- 
ed to  provide  total  flexibility  for  multiple  0S/VS1 
systems  in  the  processing  of  input  and  output 
spools.  It  provides  for  the  complete  routing  of  in- 
put jobs  as  well  as  created  output  between  any 
processors  sharing  in  the  ISP  environment. 

The  user  can  now  pool  printer  and/or  reader-punch 
resources  on  the  processor  that  will  give  the  most 
efficient  spool  processing.  This  capability  can 
significantly  enhance  the  utilization  of  these 
critical  and  expensive  resources.  Installations  us- 
ing ISP  can  determine  the  need  for  redundancy  of 
these  system  components,  based  upon  each  com- 
ponent's contribution  to  system  reliability  and  ef- 
fectiveness. 


OPERATING  EFFICIENCY 

Transmission  of  output  data  to  subsequent  CPU's 
is  implemented  using  shared  DASD  with  redun- 
dancy data  compression.  This  offers  significant 
space  saving  when  compared  to  the  JES  spool. 


OPERATOR  ASSISTANCE 

During  processing,  ISP  displays  the  number  of 
print  lines  in  each  data-set.  This  capability  will 
facilitate  the  scheduling  of  extensive  output. 


CRITICAL  SPOOL 

Each  CPU  can  route  to  any  CPU  in  the  ISP  environ- 
ment. Using  this  function  a  critical  spool  situation 
may  be  resolved  by  routing  output  data  into  the 
same  system  thus  relieving  the  overload. 

COMPRESSION 

ISP  uses  a  data  compression  algorithm  to  com- 
press redundant  data  in  any  output  lines  to  be 
transferred  to  another  CPU.  This  procedure  will 
reduce  the  space  required  for  the  output  data  by 
approximately  thirty-eight  percent. 


HARDWARE  SCHEDULING 

Pooling  of  I/O  on  one  CPU  will  allow  JES  to  op- 
timize the  use  of  the  available  peripherals.  Overall 
turnaround  lime  may  be  substantially  reduced. 


HARDWARE  CONFIGURATION 

Each  processor  no  longer  requires  a  dedicated 
card  reader  and  printer.  If  the  volume  of  cards  read 
or  lines  printed  is  not  sufficient  to  warrant  the  cur- 
rent quantity,  one  or  more  of  the  unnecessary 
units  may  be  eliminated.  Since  the  units  may  now 
be  consolidated  on  one  processor  substantial  sav- 
ings in  peripheral  control  units  are  also  possible. 

PROGRAMMING  SYSTEMS 

The  system  is  designed  to  operate  under  release 
6.0  and  all  current  releases  of  the  IBM  0S/VS1 
Operating  System. 

SYSTEM  CONFIGURATION 

Shared  direct  access  space  is  required  for  the 
transmission  of  the  reader  and  writer  data 
(approximately  250  tracks  for  each  1000  pages  of 
spooled  data). 

The  main  storage  requirement  of  the  system  is 
dependent  upon  the  function  of  the  CPU.  Approxi- 
mately 8192  bytes  of  virtual  storage  are  required 
for  each  system  sending  output.  Approximately 
2048  additional  bytes  of  virtual  storage  are  re- 
quired for  the  CPU  controlling  the  unit  record 
peripherals. 

The  operating  speed  is  dependent  upon  the  CPU 
and  Disk  devices  used.  Representative  speed  for  a 
configuration  using  a  370/158,  and  3330-1  disks  is 
approximately  250  lines  per  second. 

ISP  can  utilize  the  following  devices  provided  the 
necessary  support  is  available  in  the  level  of  VS-1 
being  used: 

CENTRAL  PROCESSING  UNITS 

370/135,  370/138,  370/145,  370/148,  370/155-11, 
370/158,  370/165-11,  370/168,  3031,  3032,  3033 

DISK  UNITS 

2314,  3330,  3330-1,  3340,  3350 

UNIT  RECORD  DEVICES 

2540,  2501,  1403-7,  1403-N1,  1443,  3211,  3800 

NUMBER  OF  CPU'S 

Concurrently  supportable— 2-36 

PfnteO  in  U  3  A 
V  1  —  7904 


CAPABILITY 

TSC  —  328X  enables  TONE  users  to  logically  con- 
nect 3270  type  display  stations  to  328X  type 
printer  devices,  enabling  the  terminal  user  to  cause 
specified  data  to  be  printed  on  the  connected 
hard-copy  device. 


OVERVIEW 

•  Encourages  effective  testing  as  users  can  now 
have  complete  hard  copy  records  of  test  ses- 
sions. 

•  Selected  copies  of  assembly  or  compile  errors 
can  be  printed  without  printing  of  entire  listings. 

•  User  CP's  can  directly  address  both  the  terminal 
and  printer  with  independently  formatted  data. 

•  Datasets  and  output  listings  can  be  printed  at 
the  terminal  location  to  reduce  turnaround  time. 

•  Facilitates  routing  of  data  between  various  re- 
mote locations. 


li^yiPLEMENTATION 

Each  printer  is  assigned  in  the  TONE.LTERM  data- 
set  to  a  logical  group.  To  connect  a  printer,  the 
terminal  user  specifies  a  group  name.  TONE  will 
select,  from  the  group  specified,  an  available 
device  and  effect  the  connection.  If  all  of  the  started 
hardcopy  devices  in  the  group  specified  are  already 
connected,  the  terminal  user  is  notified  that  no 
hard-copy  device  is  available. 

When  a  hard-copy  device  is  connected  to  a  termi- 
nal, the  mode  and  LTERM  name  are  displayed  on 
the  mode  line  (the  second  to  last  line  on  a  3270 
display  station)  in  the  form: 

COMMArJD  —  HC  ^  PRTI  —  (STD  MODE, LTERM  PRTI) 
COMMAND  —  PP  =  PRTI  —  (PGPT  MODE, LTERM  PRTI) 

The  terminal  user  may  cause  the  printer  to: 

(1)  (HC)  Connect  the  printer,  skip  the  printer  to  top 
of  form,  and  begin  following  the  terminal. 

(2)  (HT)  Connect  the  printer,  skip  the  printer  to  top 
of  form,  prmt  the  data  currently  on  the  screen, 
and  begin  following  the  terminal. 


(3)  (TOP)  Skip  to  top  of  form. 

(4)  (PGPT)  Connect  the  printer,  skip  the  printer  to 
top  of  form,  enter  page  print  mode.  The  printer 
will  print  only  when  directed. 

(5)  (CP)  Enter  continuous  print  mode.  The  printer 
will  print  each  line  as  it  is  directed  to  the 
terminal. 

(6)  ($$PGPT)  Print  the  data  currently  displayed 
on  the  screen. 

(7)  ($$POFF)  Disconnect  the  printer,  freeing  it  for 
use  by  another  terminal.  The  printer  is  dis- 
connected at  Logoff  by  default. 

The  terminal  user  may  cause  the  3270  type  dis- 
play station  to: 

(1)  ($$IEOP)  Ignore  the  normal  end-of-page  condi- 
tions. The  printer  will  continue  to  write  data 
without  intervention  by  the  terminal  user. 

(2)  ($$AEOP)  Acknowledge  the  normal  end-of-page 
conditions.  The  printer  will  be  directed  to  write 
lines  of  data  until  a  full  screen  of  data  is 
received  by  the  3270  display  station.  It  will  be 
refreshed,  showing  the  already  hard-copied 
lines  of  data,  and  will  require  "enter"  or  "clear" 
to  continue.  Depressing  the  "$SATTN"  PA  or 
PF  key  will  cause  an  interruption  to  the  active 
CP  and  return  control  to  the  terminal  user 
simultaneously  interrupting  the  printing  of 
more  data.  This  is  the  normal  mode  for  the 
terminal  and  it  is  reset  to  (AEOP)  at  user  Logoff. 

Printers  which  may  be  connected  to  the  TONE  sys- 
tem are  defined  in  the  TONE.LTERM  dataset.  The 
member  name  is  the  name  started  to  activate  the 
printer.  At  the  time  the  LTERM  is  started,  TONE 
will  write  a  TONE  logo  on  the  printer.  When  the 
printing  of  the  logo  is  complete,  the  printer  is  avail- 
able to  any  terminal  attempting  to  acquire  hard 
copy  via  the  HC  or  HT  commands. 

PROGRAMMING  SYSTEMS 

328X  is  currently  supported  under  the  current 
releases  of  TONE  3  and  TONE  4  MVS. 


TECHNICAL  SUPPORT 


INSTALLATION 


Programming  support,  enhancements  and  tech- 
nical assistance  are  included  for  the  initial  term 
of  the  contract.  Thereafter,  support  will  be  avail- 
able from  ISC  at  a  nominal  monthly  charge. 

ORDERING  INFORMATION 

328X  with  its  associated  documentation  is  cur- 
rently available.  Contact  JSC  to  order  328X. 


Installation  is  available  from  TONE  SOFTWARE 
CORP.  Installation  charges  are  based  on  time  and 
expenses. 

TRIAL  PERIOD 

The  user  will  have  thirty  days  to  evaluate  328X 
in  his  environment.  If  at  any  time  during  this 
period  the  user  decides  not  to  continue,  he  may 
return  the  package  and  all  associated  documen- 
tation without  further  obligation. 


FSO  FULL  SCREEN  OUTPUT 


OVERVIEW 

FSO,  Full  Screen  Output,  provides  the  3270  display  terminal 
user  with  a  set  of  extremely  powerful  and  flexible  commands 
to  conveniently  review  spooled  input  and  output  as  well  as 
determine  the  status  of  all  jobs  in  the  system.  With  FSO  the 
users  may  look  at  input  as  well  as  output  datasets,  search  for 
character  strings,  set  note  points  for  later  direct  reference,  page 
1  backward  or  forward,  delete  the  spooled   output,  requeue 
I  it  for  later  review,  or  print  it  on  the  system  printer.  The  output 
comn^ands  act  directly  on  the  JES  queue  and  no  intermediate 
1  file  is  necessary. 

i  In  addition  to  the  powerful  output  facilities,  FSO  provides 

! commands  which  perform  the  functions  of  IBM's  lEHPROGM 
utility  interactively.  FSO  users  may  inquire  into  the  status  of 
input  and  output  queues,  display  jobs  currently  being  processed, 
display  the  status  of  a  partition  or  address  space  including  I/O 
counts  by  DDNAME,  paging  counts,  CPU  usage  and  virtual 
storage  usage. 
A  complete  set  of  commands  is  also  included  to  aid  the  systems 
programmer.  These  include  the  ability  to  display  and  alter 
virtual  storage  by  offset,  to  locate  modules  and  their  associated 
i  pointers  in  the  link  pack,  job  pack,  or  resident  SVC  area  and  the 
ability  to  display  formatted  UCB's  and  TCB's.  An  absolute 
|;  cancel  facility  is  also  provided. 

:  SPOOLED  INPUT/OUTPUT  REVIEW 

FSO  allows  the  user  to  easily  obtain  and  manipulate  input/out- 
put directly  from  the  spool  without  JCL  modifications.  Once 
the  data  has  been  retrieved  the  user  may: 

\]  •  Scroll  vertically  or  horizontally 

■  •  Search  for  a  specified  character  string 

|i  •  Page  forward  or  backward 

I'  •  Set  reference  points  for  subsequent  return 

I  •  Delete  or  requeue  for  subsequent  processing 

!  STATUS  COIVIIVIANDS 

FSO  Status  CoiTimands  permit  the  user  to: 

•  Display  active  jobs 

|.|  •   Dis()lay  jobnamos  on  input  or  output  queues 
•}  •   Display   detailed    information    about   an    active  partition 
or  job 

•  Display  jobqueue  status 

h  •   Display  outstanding  requests 

h  DATA  SET  UTILITY  FUNCTIONS 

li  Through  the  usl'  of  rlie  FSO  Djia  Set  Utility  Functions  the 
f;  user  may  perform  most  functions  of  the  IBM  lEHPROGM 
si  utility  online.  Inciud  .",!  among  these  functions  is  the  ability  to: 

i'  •  Connect  or  <ii:\t'U:  a  hujli  incJex 

ji  •  Cro-ni;  01  dei-'t..'  (icikm  =11  ion  data  gioup  indicies 

•  C.itaioq  or  up' ,ir,;l. vi  .i  d.itj.^et 

•  LiU  til','  CJt..K,': 

ji  •    Ron  i!'>'  oi  '.craicn  dat.iS'jts 

'l  •    D.-ti.riiiin.;  rh"        rpace  on  a  volume 

•  Lot  r '.-y.  r.\,r  I  'JGCB  1 1 '  f  OI  m .i t ; Oil 


ALTER/DISPLAY  FUNCTIONS 

This  set  of  flexible  commands  provides  the  systems  programmer 
with  the  following  capabilities: 

•  Easily  display  or  alter  virtual  storage 

•  Locate  modules  in  LPA  or  JPAQ 

•  Locate  resident  SVC's 

•  Display  TCB's    (VSl  only) 

•  Display  UCB's 

•  Express  cancel  a  TCB    (VS1  only) 

These  commands  may  be  restricted  to  specified  individuals 
through  easily  programmed  exits. 

PARTIAL  COMMAND  LISTING 

The  following  brief  listing  is  a  representative  sample  of  the 
more  than  70  commands  currently  available  with  FSO. 


DELETE  -  Delete  job  from  system  ..  : 

FIND  -  Locate  specific  string         V  '  ■ 

INDEX  -  Display  SYSOUT  index 

LIST  -  List  selected  portions  to  SYSOUT 

INPUT  -  Retrieve  from  Input  Queue 

OUTPUT  -  Retrieve  from  Output  Queue 

SAVE  -  Requeue  the  current  job 

DA  -  Display  active  jobs  in  the  system 

DN  -  Display  all  jobs  on  all  Queues 

DP  -  Display  an  active  partition 

DR  -  Display  outstanding  requests 

STATUS  -  Determine  the  status  of  a  job 

DV  -  Display  virtual  storage 


PROGRAMMING  SYSTEMS 

FSO  is  supported  under  all  current  releases  of  0S/VS1  and  MVS 
and  functions  under  various  teleprocessing  monitors  including 
TONE  3  and  TONE  4  (TONE  SOFTWARE  CORP.),  Roscoe 
(Applied  Data  Research,  Inc.),  TSO  and  CICS/VS  (IBM  Corp.) 
and  Shadow  (Altergo  Software  Inc.).  FSO  also  functions  in 
batch  or  from  the  operator's  console.  The  display  stations 
supported  include  any  local  or  remote  3270  or  compatible  de- 
vice ranging  from  12  to  43  display  lines  and  80  or  132  columns. 


TECHNICAL  SUPPORT 

Programming  support  enhancements  and  technical  assistance 
are  included  in  the  lease  price.  Under  a  Fully  Paid  License, 
support  is  availabli!  at  no  charge  for  the  first  year  and  for  a 
nominal  fee  thereafter. 


TRIAL  PERIOD 

TONE  SOFTWARE  CORPORATION  offers  the  customer  a 
30-day  tn;il  period  to  evaluate  FSO.  If  at  any  time  during  this 
trial  perioii  the  user  decides  not  to  continue  the  evaluation, 
the  system  and  documentation  may  be  returned  without 
ol)l  igation. 


TONE  SO  FT  WARE  CORP 
•Q)  V  2-8010 


¥SM  ^^LL  SCREEN  MODE 


OVERVIEW  ' 

The  Full  Screen  Mode  (FSM)  of  data  editing  provides  users  with 
the  full  capabilities  of  3270  protocol.  The  terminal  user  may, 
through  the  3270,  define  the  field  to  be  edited,  position  the 
cursor  anywhere  on  the  screen  and  make  the  desired  edits. 
fSM  has  the  ability  to  process  the  entire  screen  of  new  or 
updated  data  regardless  of  screen  size.  The  term  3270  refers 
to  a  class  of  devices  including  local  and  remote  3275,  3277, 
3278,  and  3279  terminals  with  screen  sizes  of  24x80,  32x80, 
43x80,  and  27x132  characters.  FSM  greatly  enhances  produc- 
tivity through: 

•  Full  Screen  processing  ,  .  ■  '    ■  '  - 

•  Enhanced  terminal  useability 

•  Simplified  line  commands  '  - 

•  Hexadecimal  editing  ; 

•  Extended  NONUM  support  ' 

•  New  EDIT  subcommands 

FULL  SCREEN  PROCESSING:  FSM  reads  and  processes  an 
entire  screen  of  new  and/or  modified  data  in  one  service  cycle. 
All  processing  required  for  the  screen  is  performed  before  the 
display  is  updated.  This  is  done  for  all  standard  screen  sizes 
and  results  in  a  significant  reduction  in  overhead  for  the  trans- 
mission of  data. 

ENHANCED  TERMINAL  USEABILITY:  The  user  is  provided 
with: 

Logical  Tabs  -  The  user  may  enter  data  using  the  designated 
character  to  represent  a  tab.  When  data  is  processed, 
blanks  are  inserted  to  align  the  d  ata  as  directed. 

Screen  Format  -  The  format  provides  a  command  line, 
descriptor  area,  tab  templates,  column  templates,  and  a 
data  area,  variable  in  size  depending  upon  the  number  of 
lines  displayable  on  the  screen.  ■  :  ■ 

3270  Features  -  Within  the  data  area  the  user  may  overtype 
existing  data,  and  use  character  insertion  and  deletion  to 
move  or  align  new  and/or  existing  data. 

SIMPLIFIED  LINE  COMMANDS:  FSM  provides  the  capability 
to  move,  copy  or  delete  siiujle  or  contiguous  i)iocks  of  limis 
simply  with  the  use  of  one  or  f  vo  character  commands.  This 
eliminates  the  need  for  entering  line  numbeis  and  speeds  the 
editing  process. 

HEXADECIMAL  EDIT  SUPPORT:  FSM  provides  the  ability 
to  create  or  modify  data  fit.'Ids  in  HEX.  The  HEX  editing  feature 
provides  a  powerful  tool  in  tlie  rlevelopment  or  correction  of 
data.  It  allows  the  user  to  display  fields  that  are  hexadecimal  or 
packed  decimal  and  to  modify  the  value  of  these  fields.  All 
data  IS  displayi.-d  in  2  char.ictLM  byte  i epresentation.  Sub- 
comrnan<ls  exist  to  <lisol.iy  only  ivxadecimal  representation  or, 
t'.vo  lines  can  provide;'),  ont;  containing  hexadecimal  and  tlie 
other  in  charactu-r  f';rmat. 


EXTENDED  "lONU.M  SUPPORT 
(!,u-.;  NOrJUM  Mat.; 
.ri  "(lit  (j'.'ni.'rar  n! 
Inituily,  Ihe'.i;  ic^ 

iH'-.oi  TlOflS  M'l/w 
rSM    c:l;w.%S    tlv;  : 

i"o,ni".,i'v!  J  'usr 


I'ts  us  i:  thi'y 
•  ire  :ujnii;''r 

ll'iintj.M  ',  olr' 

■      'ne  inri^Mi 


FSM  allr;ws  rhe  user  to  u[)- 
y>.'io  nuir.hi.M  i'<i .  It  can  display 
)n  rlT(>  left  si'lii  of  Th(,'  line, 
r.cremenr-ri  !,■/  100,  but  line 


ADDITIONAL  EDIT  SUBCOMMANDS: 

ASIS  -  Set  the  dataset  into  ASIS  mode. 
CAPS  -  Set  the  dataset  into  CAPS  mode. 
CHAR  -  Display  the  data  in  the  line  display  in  character 
mode. 

COL  (n  m)  -  Change  the  columns  displayed  to  "n"  for  "m" 
columns. 

COL  C  -  Move  the  display  to  the  column  in  which  the 

cursor  is  positioned. 
COL  L  -  Move  the  display  LEFT  one  half  of  the  screen 

width. 

COL  R  -  Move  the  display  right  one  half  of  the  screen 
width. 

COL  — n  -  Move  the  display  left  "n"  columns. 
COL  +n  -  Move  the  display  right  "n"  columns. 

DCB  -  Display  the  DCS  attributes  of  the  edited  dataset. 
Dl  -  Display  the  last  EDIT  command  entered  through 
,  , : ,  FSM. 

E  (F)  -  Terminate  FSM,  and  optionally  free  the  buffer 
area. 

EM  (c)  -  Enter  edit  mode  and  optionally  change  the 
trailing  blank  character  for  variable  length 
records. 

FILL  (n)  -  Set  the  fill  column  to  n  (default  of  last). 

HB  (n)  -  Move  the  display  backward  n  half-pages  of  data. 
HEX  (n)  -  Display  the  data  in  the  line  display  in  hexa- 
decimal mode. 

HF  (n)  -  Move  the  display  forward  n  half-pages  of  data. 
MD  (n)  -  Move  the  display  to  line  n,  or  before  if  non- 
existant. 

MDR  (n)  -  Move  the  display  to  line  n,  and  remember  current 
line. 

NOFILL  -  Set  the  fill  column  to  0. 

PB  (n)  -  Move  the  display  backward  n  pages  of  data. 
PF  (n)  -  Move   the  display  forward   n   pages  of  data. 
RESET  -  Reset  all  pending  line  commands  and  messages. 
SM  (c)  -  Enter  scan   mode  and  optionally   change  the 
trailing    blank    character    for    variable  length 
records. 

TABS  ON  -  Allow  tab  processing  to  be  done  by  FSM. 
TABS  OFF  -  Disallow  tab  processing  for  FSM. 


TECHNICAL  SUPPORT 

Programming  support,  enhancements  and  technical  assistance 
are  includi'd  in  the  lease  price.  Under  a  Fully  Paid  License, 
support  is  includt^d  at  no  charge  for  the  first  year  and  available 
for  a  nominal  fee  thereafter. 


i-'iits  •^injiifi.  Tt'MS  facility  of 
■  jiur.d.Hii  'ditor  line  nuinni.T 
"  .'■s   rfjn'"  iirv'd   !;ne  numhors. 


TRIAL  PERIOD 


TONE  SOFTWARE  CORPORATION  offers  the  custom.er  a 
30  day  trial  period  to  rvalujle  FSM.  If  at  any  time  during  this 
trial  piMiod  thH  user  dt'Cides  not  to  continue  the  evaluation, 
tht;  system  and  'Jocum^.-ntatiori  may  be  returned  without 
ot)l  illation. 


cry 


©    TO  N  E  SO  FT  WV  A  R  E  CORP. 
V  2-80 1 0 


i  PAM  INTERACTIVE  PAr^JVALET  COMMAND  PROCESSOR 


OVERVIEW 

TPAN,  Interactive  PANVALET  Command  Processor, 
provides  the  user  with  the  ability  to  fully  utilize 
the  facilities  of  the  PANVALET  system  interactively 
in  a  TONE  or  TSO  environment.  TPAN  enables  the 
user  to  access  PANVALET  libraries  as  well  as  store, 
retrieve,  copy  or  delete  datasets  using  a  free  form 
command  structure.  System  and  programmer  efficiency 
are  improved  through  the  use  of  the  following  facilities. 

A  reduced  requirement  for  disk  space  by  storing 
modules  not  currently  needed  on  the  PANVALET 
master  file  in  a  compressed  format. 

Simplified  management  of  PANVALET  system  by 
providing  the  data  manager  terminal  access  to  the 
directory.  , 

Simplified   programmer  use  by   providing  free 
form  input  and  extensive  prompting. 

Encourages  tfie  use  of  common  routines  which 
can  be  stored  in  a  PANVALET  library  and  re- 
treived  by  any  authorized  programmer. 


COMMAND  FUNCTIONS 


•  Select  parts  of  datasets  from  a  PANVALET  library 
into  a  TONE/TSO  dataset 

•  Change  the  attributes  of  a  dataset,  superset  or  sub- 
set in  the  PANVALET  library  including 

—  Comment 

—  Format 

—  Status 

—  User  code 

•  List  dataset,  superset  or  subset  information  from  a 
PANVALET  library  directory 

•  Switch  from  one  PANVALET  library  to  another 

•  Obtain  HE  LP  command  support 

TPAN  commands  or  subcommands  may  be  issued  in 
any  sequence. 


PROGRAMMING  SYSTEMS 

TPAN  is  supported  under  the  current  releases  of 
TONE  3,  TONE  4  MVS  and  MVS  TSO. 


TECHNICAL  SUPPORT 

Programming  support,  enhancements,  and  technical 
assistance  are  provided  for  the  term  of  the  initial  con- 
tract. Thereafter,  support  will  be  available  from  Tone 
Software  Corporation  at  a  nominal  charge. 


Commands  are  contained  in  TPAN  which  allow  the 
user  to: 

•  Add  datasets,  supersets,  and/or  subsets  to  a  PAN- 
VALET library 

•  Update  datasets,  sufjersets,  and/or  subsets  in  a  PAN- 
VALET library 

•  Delete  subsets  from  a  PANVALET  library 

•  Copy  a  dataset,  superset  or  subset  in  a  PANVALET 
library 

•  Retrieve  a  dataset,  superset  and/or  subset  from  a 
PANVALET  liijrnry  for  subsequent  editing  with  the 
powerful  TONE  TSO  editor 

•  Renan^e  a  dataset,  sui:)erset  and/or  sui^set  in  a  PAN- 
VALET iibr.iry 


INSTALLATION 

While  it  is  recommended  that  the  customer  install 
TPAN,  installation  is  available  from  Tone  Software 
Corporation  on  a  time  and  expenses  basis. 


TRIAL  PERIOD 

Tone  Software  Corporation  offers  the  customer  30 
days  to  evaluate  TPAN  software  and  associated  docu- 
mentation free  of  charge  and  without  further  obiiga- 
t\on. 


^       TC^e    SOf^TWVARe    C  Off  f . 


TRIAL  AGREEMENT 


AGREEMENT,  made  this  ^day  of  '',19 

by  and  between  TONE  SOFTWARE  CORPORATION   (TSC)  and   

  (Customer) . 


TSC  and  Customer  agree  to  install   

software  at  Customer's    facility  for 

a  30-day  free  trial  period  beginning   

and  ending   ;  and 


Customer  understands  that  the  above-referenced  software  is  a  trade 
secret  of  TSC  and  agrees  that  it  will  protect  the  trade  secret  software 
and  that  it  will  not  copy  said  trade  secret  software  or  any  portion 
thereof  to  make  said  trade  secret  software  available  to  third  parties. 

Should  Customer  be  dissatisfied  with  said  software.  Customer  agrees  to 
extract  said  trade  secret  software  from  any  other  software  into  which  it 
may  have  been  merged  and  return  all  software  and  transmittal  media  to 
TSC  and  destroy  any  other  form  of  said  software  at  the  completion  of 
said  trial  period.     Upon  such  election.  Customer  agrees  to  certify  in 
writing  that  all  aforementioned  software  has  been  returned  or  destroyed. 

Should  Customer  for  any  reason  fail  to  return  or  destroy  said  software 
at  the  end  of  said  30-day  trial  period.  Customer  agrees  to  commence 
paying  the  then  current  charge  applicable  for  the  rental  of  said  soft- 
ware on  a  month-to-month  basis,  until  such  time  as  a  written  Lease  or 
License  Agreement  is  entered  into  between  Customer  and  TSC. 


Company 


Signature 


Name  typed  or  printed 


Title 


Software  Corp. 
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Software  Corp. 


TONE  PRODUCTS  AGREEMENT 

AGREEMENT,  made  this  day  of  .  ,  19  ,  between 

TONE  SOFTWARE  CORPORATION  (TSC)  and  

(Customer),  is  made  with  reference  to  the  following: 

WHEREAS  TSC  is  the  owner  of  certain  proprietary  computer  programs  and  related  information; 
and, 

WHEREAS  Customer  desires  to  make  use  of  specified  TSC  products  under  the  following  conditions 
and  covenants, 

THEREFORE,  it  is  agreed  as  follows: 
LICENSE  TO  USE 

1.     TSC  grants  to  Customer  for  the  period  of  this  contract  and  any  extension  thereof,  a  non- 

transferrable,  non-exclusive  right  to  use  the  "  licensed  software"  at  its  

'.'facility",  and  no  other,  at  the  charges  specified  below: 

Item  Term  Monthly  Charge  Fully-paid  License 


TOTAL:      

"Licensed  software"  will  include  the  programs  and  all  related  documentation. 

"Facility"  shall  be  defined  as  a  particular  data  center  or  computer  operations  center  in  a  single, 
specific  location. 

TRIALPERIOD 


2.  Upon  receipt  of  an  executed  copy  of  this  Agreement,  TSC  agrees  to  furnish  the  licensed  soft- 
ware without  cost  to  Customer  for  a  trial  period  commencing  . 

and  ending  .  Customer  understands  that  it  will  incur 

no  liability  under  this  contract  if  during  said  trial  period  Customer  manifests  its  intention  not  to 
complete  this  contract  by  returning  said  licensed  software  and  related  documentation  to  TSC  or 
certifies  in  writing  that  the  licensed  software  has  been  destroyed.  Provided,  Customer  shall  be  en- 
titleri  ro  one  trial  period,  whether  by  this  agreement,  or  by  a  separate  trial  agreement. 


TERM 


3.  If  Customer  manifests  its  intention  to  complete  this  contract  by  failing  to  return  said  licensed 
software,  it  shall  commence  paying  the  charges  as  shown  in  Paragraph  1  above  on  the  first  day 
following  the  completion  of  the  trial  period.  Customer  shall  continue  to  pay  the  monthly  charges 

for  months  (initial  term),  and  may  thereafter  continue  to  lease  said  licensed  software  on  a 

month-to-month  basis  at  the  then  current  monthly  charge.  Monthly  charges  will  be  invoiced  in 
advance  and  will  be  payable  within  thirty  (30)  days  after  the  date  of  invoice.  Charges  for  a  partial 
month's  use  will  be  prorated  based  on  a  thirty  (30)  day  month, 

CONDITIONS  OF  CANCELLATION 


4.  During  the  initial  term,  TSC  cannot  cancel  this  agreement  or  increase  the  monthly  charge  as 
long  as  Customer  is  not  in  default  of  this  agreement.  Any  monthly  installment  which  is  not  paid 
within  30  days  of  the  date  of  invoice  shall  be  subject  to  a  10%  late  charge.  In  addition,  TSC  reserves 
the  right  to  cancel  this  agreement  if  any  invoice  becomes  sixty  (60)  days  delinquent.  Any  reinstate- 
ment of  this  contract  following  such  default  shall  be  at  the  option  of  TSC,  and  in  all  cases  the 
contract  will  only  be  reinstated  according  to  the  then  current  charges,  terms  and  conditions.  Cus- 
tomer may  cancel  this  agreement  at  any  time  following  the  initial  term  upon  thirty  (30)  days 
written  notice  to  TSC. 

WARRANTY 

5.  TSC  warrants  that  said  licensed  software  will  meet  its  published  design  objectives  and  spec- 
ifications and  agrees  to  promptly  correct  without  charge  any  faults  or  inaccuracies  which  arise 
solely  in  conjunction  with  the  utilization  of  said  software.  Customer  agrees  to  provide  TSC  repre- 
sentative with  machine  and/or  personnel  resources  as  may  be  required  to  solve  problems.  TSC 
further  agrees  to  service  said  software  and  provide  consultation  to  Customer  with  regard  to  prob- 
lems which  arise  in  connection  with  Customer's  modification,  or  provide  technical  support  for 
enhancements  requested  by  Customer  when  Customer  agrees  to  pay  TSC's  normal  hourly  rate  from 
time  to  time  in  effect  for  such  service  or  support.  TSC,  however,  disclaims  any  warranties  express 
or  implied  concerning  the  effectiveness  of  any  modifications  to  said  licensed  software  and  assumes 
no  liability  for  loss,  personal  injury,  death  or  property  damage  arising  out  of  the  use  or  application 
of  said  licensed  software.  THIS  WARRANTY  IS  IN  LIEU  OF  ANY  OTHER  WARRANTY  EITHER 
EXPRESSED  OR  IMPLIED. 

PROGRAM  SUPPORT 


6.  TSC  will  provide  system  and  program  technical  support  at  no  cost  to  Customers  leasing  the 
licensed  software  and  for  the  first  12  months  to  all  Customers  who  acquire  a  Fully  Paid  License 
(FPL).  TSC  shall  continue  to  provide  such  support  following  the  first  12  months  for  Customers  who 
acquire  an  FPL  for  a  dollar  sum  annually  equal  to  15%  of  the  then  current  FPL  rate  for  the  licensed 
software  unless  Customer  notifies  TSC  in  writing  not  to  provide  such  support  not  less  than  30 
days  prior  to  the  expiration  of  the  initial  1 2-month  period. 

CUSTOMER  RESTRICTIONS 


7.  Customer  shall  not  copy,  in  whole  or  in  part,  any  licensed  software  materials  which  are  pro- 
vided by  TSC  under  this  Agreement  except  to  :  (a)  Modify  the  licensed  software  as  provided  below, 
or  (b)  Provide  for  operation  and  backup.  The  Customer  agrees  to  maintain  appropriate  records  of 
the  number  and  location  of  all  copies  made.  The  original,  and  any  copies  of  the  licensed  software, 
in  whole  or  in  part,  which  are  made,  shall  be  the  property  of  TSC. 


1 


MODIFICATION  OF  LICENSED  SOFTWARE 


8.  Customer  may  modify  said  licensed  software  for  its  own  use  and  merge  it  into  other  program 
material  to  form  an  updated  work,  provided  that,  upon  discontinuance  of  the  license,  the  software 
supplied  by  TSC  will  be  completely  removed  from  the  updated  work  and  dealt  with  under  this 
Agreement  as  if  permission  to  modify  had  never  been  granted.  The  updated  work,  or  any  portion 
thereof,  shall  be  used  only  at  the  designated  site.  Customer  agrees  to  forward  to  TSC  the  modified 
or  updated  software  and  such  modified  or  updated  software  may  be  used  by  TSC  for  any  purpose 
without  charge. 

INSPECTION  OF  CUSTOMER  SITE 


9.  Title  to  all  licensed  software  and  any  reproduction  thereof  supplied  to  Customer  by  TSC 
remains  with  TSC  and  Customer  agrees  to  return  all  such  software  to  TSC  within  thirty  (30)  days 
after  termination  of  this  Agreement.  Customer  further  agrees  that  it  will  certify  that  such  software 
has  been  returned  and  that  TSC  shall  have  the  right  to  inspect  Customer's  facilities  within  six 
months  following  the  termination  of  this  Agreement  in  order  to  verify  that  all  licensed  software 
has  been  returned.  TSC  agrees  that  any  such  inspection  will  be  conducted  during  normal  working 
hours  at  a  time  which  will  not  unreasonably  interfere  with  the  tasks  to  be  performed  by  Customer's 
equipment  and/or  personnel. 

INDEMNITY  -  PATENT  AND  COPYRIGHT 


10.  TSC  will  defend,  at  its  expense,  any  action  brought  against  the  Customer  to  the  extent  it  is 
based  on  a  claim  that  licensed  software  infringes  upon  a  United  States  Patent  or  Copyright,  and 
pay  any  costs  and  damages  finally  awarded  against  Customer  provided,  however,  thatTSC's  liability 
shall  be  limited  as  follows: 

(a)  TSC  shall  in  no  event  be  liable  for  damages  in  excess  of  $20,000.00 

(b)  TSC  shall  have  the  right  to  procure  for  Customer  a  license  to  continue  using  said  licensed 
software,  or  to  replace  or  modify  said  software  to  make  said  licensed  software  non- 
infringing. TSC  shall  have  no  liability  for  any  claim  based  upon  the  continued  use  of 
unmodified  infringing  software  after  notice  in  writing  by  TSC  to  cease  using  the  in- 
fringing software 

(c)  TSC  shall  have  no  liability  for  any  infringement  which  results  from  the  use  of  the  licensed 
software  in  combination  with  any  other  proprietary  product 

(d)  Customer  shall  promptly  notify  TSC  in  writing  of  the  claims  and  TSC  shall  have  sole 
control  of  the  defense  and  all  related  settlement. 

RISK  OF  LOSS 

11.  If  any  licensed  software  is  lost  or  damaged  during  shipment,  TSC  will  replace  the  licensed 
software  and  program  storage  media  at  no  additional  charge  to  the  Customer.  If  any  licensed  soft- 
ware is  lost  or  damaged  while  in  the  possession  of  the  Customer,  TSC  will  replace  the  licensed  soft- 
ware at  a  charge  for  program  storage  media,  unless  it  is  provided  by  the  Customer. 


PROTECTION  OF  TRADE  SECRET 


12.  Customer  agrees  that  said  licensed  software  and  any  enhancements  are  a  trade  secret  of  TSC. 
Customer  agrees  that  it  will  not,  at  any  time  either  during  or  after  this  agreement,  make  available 
to  third  parties  said  licensed  software  or  any  information  which  may  be  construed  to  be  an  im- 
provement on,  or  a  derivative  of,  the  licensed  software  or  related  information.  Customer  further 
agrees  that  it  shall  take  reasonable  precautions  to  assure  that  this  Agreement  is  binding  upon  all 
its  employees  present  or  future,  and  enforceable  against  them.  Customer's  modifications  of  any  part 
of  said  licensed  software  shall  be  preserved  in  confidence  to  the  same  extent  as  the  original  licensed 
software  supplied  by  TSC,  and  the  modified  software  shall  be  governed  by  the  terms  of  this  agree- 
ment. 


ATTORNEY'S  FEES 


13.  In  the  event  any  party  to  this  Agreement  brings  legal  action  or  commences  litigation  or  em- 
ploys legal  counsel  to  enforce  any  provision  herein,  the  prevailing  party  shall,  in  addition  to  any 
other  remedy  afforded  it,  be  entitled  to  reasonable  attorney's  fees  as  determined  by  the  court. 

GOVERNING  LAWS 


14.  The  validity,  construction  and  performance  of  this  agreement  shall  be  governed  by  the  laws 
of  the  State  of  California,  excluding  that  body  of  law  applicable  to  choice  of  laws,  and  if  any  pro- 
vision of  this  agreement  or  application  of  provision  of  the  agreement  shall  be  held  by  a  court  of 
competent  jurisdiction  to  be  contrary  to  law,  the  remaining  provisions  of  this  agreement  shall 
remain  in  full  force  and  effect.  ' 

IN  WITNESS  THEREOF,  the  respective  parties  have  hereunto  affixed  their  signature  the  day  and 
1  year  first  above  written. 


CUSTOMER: 


TONE  SOFTWARE  CORPORATION 


By: 


By: 


Name  typed  or  printed 


Name  typed  or  printed 


Title 


Title 


Date  Executed 


Date  Executed 


1124  N.Gilbert  •  Anaheim,  California  92801  •  Phone:(714)991-9460  •  Telex:  1 81 -592 


EFFECTIVE 
SEPTEMBER  26,  1980 


TONE  PRODUCT  PRICE  LIST 


PRODUCT 


MONTHLY  LEASE 


FULLY  PAID 
LICENSE 


TONE  3 

TONE  4 

FSM 

FSO 

328X 

ISP 

PHASOR 

TLIB 

TPAN 


TYPE   3  LIBPJIRY 


$825.00  per  mo. 
$825.00  per  mo. 
$165.00  per  mo. 
$200.00  per  mo, 
$150.00  per  mo. 
Not  available 

$225.00  per  mo. 
$  75.00  per  mo, 
$  7  5.00  per  mo. 
$200.00  per  mo. 


$26,500.00 

$29,900.00 

$  4,000.00 

$  7,500.00 

$  4,500.00 

$11,500.00  or 
$1,500.00  for  12 

$  6,500.00 

$  2,500.00 

$  2,500.00 

Not  available 


«•  Full  maintenance  is  included  in  all  leases. 

o  A  minimum  term  of  one  year  is  required  for  all  leases.  Extended 
term  discounts  are  available. 

«  One  year  of  maintenance  included  on  all  Fully  Paid  Licenses. 
Maintenance  is  optional  thereafter  at  a  cost  of  15%/year  of  the 
then  current  Fully  Paid  License  price. 


»  Discounts  are  available  for  installation  at  multiple  sites. 
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W YLBUR 


On-Line  Business  Systems,  Inc. 

1 1 5  Sansome  Street 
San  Francisco,  California  941 04 
(415)  391-9555 


T.M.= 


®  Program  Development  On-line 


^  Interactive  Text  Editing 


CardSess  Prodyction 


WHAT  IS  WYLBUR? 


WYLBUR  is  a  conversational  system  that  allows 
users  located  at  interactive  terminals  to: 


messages,  and  output  associated  with  specific 
SYSOUT  DD  statements. 


Create  and  interactively  manipulate  text  using 
one  of  the  most  powerful  text  editors  avail- 
able. Text  IS  stored  in  and  retrieved  from 
standard  OS  data  sets. 

Submit  jobs  directly  to  the  operating  system 
for  execution  in  the  batch  environment. 

Control  the  execution  of  jobs  submitted 
through  WYLBUR. 

Retrieve  at  the  terminal  all  or  specific  parts  of 
spooled  |ob  output  including  the  )ob  log,  JCL 


•  Use  the  WYLBUR  EXEC  language  features  to 
create  interactive  routines  to  perform  data 
entry,  conversions,  calculations  or  any  fre- 
quently used  process. 

•  Query  the  system  directly  for  information  con- 
tained in  the  catalog,  disk  volume  tables  of 
contents  (VTOC's)  and  partitioned  data  set 
directories. 

•  Develop  word  processing  applications  for 
documentation,  proposals,  mailing  lists,  you 
name  it. 


•  W  >  1  (U,  R  IS  a  trademark  ot  The  l^oard  of  Trustees  of  The  Leiand  Stanford  )  unior  University 


WHY  DO  YOU  NEED  WYLBUR? 

•  If  you  would  like  to  decrease  system  develop- 
ment time  by  dramatically  increasing  staff 
productivity 

-  YOU  NEED  WYLBUR 

•  If  you  would  like  a  "cardless"  production  en- 
vironment to  simplify  job  submission,  save 
time  and  minimize  control  errors 

-  YOU  NEED  WYLBUR 

•  If  you  would  like  to  overhaul  your  procedure 
library  or  clean  up  that  old  1401  application 

-  YOU  NEED  WYLBUR 

•  If  you  would  like  to  significantly  reduce  aver- 
age test  turnaround  time 

-  YOU  NEED  WYLBUR 

•  If  you  would  like  to  have  the  power  of  your 
computer  anywhere  there  is  a  telephone 

-  YOU  NEED  WYLBUR 


•  If  you  would  like  to  streamline  and  automate 
your  administrative  document  processing 

-  YOU  NEED  WYLBUR 

•  If  you  have  a  conversion  coming  up  that  re- 
quires many  source  programs  or  JCL  sets  to  be 
modified 

-  YOU  NEED  WYLBUR 

•  If  you  would  like  to  develop  computer-aided- 
instruction  courses  for  users  or  your  own 
staff 

-  YOU  NEED  WYLBUR 

•  If  you  don't  want  to  spend  a  lot  of  money  to 
obtam  and  run  an  mteractive  text  manipula- 
tion/ R|E  system 

-  YOU  NEED  WYLBUR 


EVERY  TEXT  EDITOR  IS 
"ONE  OF  THE  MOST  POWERFUL"  - 
WHAT  DOES  WYLBUR  HAVE  TO 
'    BACK  UP  ITS  CLAIM? 

WYLBUR  text  manipulation  commands  are  used 
to  create  or  modify  source  programs,  documenta- 
tion, correspondence,  test  data,  job  control 
statements  (JCL)  or  other  text.  It's  easy  for  tech- 
nical or  non-technical  personnel  to  become  ef- 
fective WYLBUR  users  with  a  few  hours  of  train- 
ing because  it  uses  English-like,  free  format  com- 
mands. One  simply  backspaces  over  typing 
errors  and  retypes.  WYLBUR  will  reject  most 
input  command  errors  with  a  short  but  informa- 
tive message  or  will  prompt  for  omissions.  A 
command,  like  any  piece  of  text,  can  be  edited 
or  modified,  thus  eliminating  the  need  to  com- 
pletely retype  commands  —  even  those  which  the 
system  has  rejected  as  erroneous. 

Editing  commands  operate  on  a  working  or 
'active'  file  for  each  concurrent  user.  Text  from 
other  data  sets  may  be  copied,  in  whole  or  in 
part,  into  the  active  file.  Working  files  may  con- 
tain up  to  10,000  lines,  depending  on  the  den- 
sity of  the  text.  All  lines  of  text  may  be  refer- 
enced either  by  line  number  or  by  text  content. 
Line  numbers  may  contain  up  to  8  digits  (not 
included  in  line  length)  for  easy  insertion  of 
large  groups  of  text.  The  working  file  may  also 
be  re-numbered  at  any  time  during  a  WYLBUR 
session. 

Text  manipulation  features  include: 

•  Upper  and  lower  case 

•  Full  support  of  "tabs"  for  easy  text  collection 
and  rapid  list  back 

•  Compression  of  stored  text  (user  option) 

•  Storage  of  text  in  standard  OS  data  sets 
(sequential  and  partitioned) 

•  Manipulation  of  single  lines,  ranges  of  lines, 
entire  text 

•  Ability  to  reference  column  positions  within 
lines 

•  Full  text  recovery  after  system  or  line  failures 
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•  Prompting  after  erroneous  commands  for  cor- 
rection/ reentry 

•  Grouping  of  commands  so  that  they  may  be 
stored  and  called  as  a  unit  for  easy  execution 
of  common  routines 

•  Use  of  abbreviated  commands  (optional  for 
experienced  users) 

•  Variable  line  length  up  to  a  maximum  of 
133  characters 

•  Global  search  or  replacement  of  character 
strings 

•  Copy  and  move  functions 

•  Keyword  protection  against  file  alteration  and 
unauthorized  use  of  computer  resources 

•  Off-line  printing  of  selected  portions  or  of 
entire  text  files 

•  Ability  to  access  ordinary  OS  data  sets  wheth- 
er or  not  they  were  created  via  WYLBUR. 


HOW  DOES  IT  WORK? 

V  WYLBUR  executes  as  a  conventional  job  under 
OS  or  OS/VS  on  IBM  370  systems.  WYLBUR  may 
run  24  hours  per  day  or  be  terminated  when  its 
services  are  not  required.  An  idle  system  consumes 
almost  no  resources.  It  must  run  at  a  high  dis- 
patching priority  in  order  to  ensure  good  response 
time  (normally  one  second  or  less).  Because 
WYLBUR  was  designed  for  maximum  efficiency, 
it  can  run  at  high  priority,  provide  excellent  re- 
sponse time  to  users  and  have  very  minimal  impact 
on  batch  throughput.  For  example,  30  to  50  con- 
current users  can  enjoy  excellent  response  time 
in  384K  of  virtual  storage  on  a  370/158  without 
hampering  batch  work.  On-line  applications  (CICS, 
for  example)  can  run  concurrently  with  WYLBUR. 


HOW  DOES  THE  USER  SUBMIT 
AND  CONTROL  JOBS? 

The  user  creates  a  set  of  JCL  (by  copying  a  pro- 
cedure library  member  and  then  modifying  the 
copy,  for  example)  to  compile  and/or  execute 
one  or  more  programs.  The  user  may  then  use 
the  following  WYLBUR  commands  to  submit  and 
control  his  job  (Users  cannot  affect  jobs  sub- 
mitted by  others): 

RUN         -  Submit  job 

HOLD      —  Place  job  in  system  hold  status 

LOCATE    —  Show  job  status; 

Awaiting  Execution 

Executing 

Awaiting  Output 

Awaiting  Fetch 

Not  Found 
RELEASE   —  Release  job  from  hold  status 
CANCEL    —  Cancel  an  executing  job 
PURGE      —  Cancel  job  output 
ROUTE     —  Assign  spooled  output  to  remote 

or  central  printers 
f  ETCE1      —  Retrieve  spooled  output  at  the 
te.'rminai 


HOW  MUCH  DOES  IT  COST  TO  OPERATE? 

After  a  data  processing  manager  discovers  what 
can  be  accomplished  with  this  powerful  system, 
he  or  she  is  ready  for  the  most  pleasant  surprise 
of  all  —  the  cost  to  obtain  and  operate  WYL- 
BUR. While  processing  costs  vary  with  the  num- 
ber of  concurrent  users  and  computing  resources 
available,  we  are  confident  you  will  agree  that 
WYLBUR  is  inexpensive  to  operate.  For  ex- 
ample, CPU  utilization  averages  16-20  CPU  sec- 
onds per  connect  hour  on  the  OBS  370/158, 
Model  1.  Further  details  on  resource  utilization 
are  available  upon  request. 

We  urge  you  to  compare  WYLBUR  to  TSO  and 
other  systems  of  similar  nature.  Compare  fea- 
tures. Compare  response  time.  Compare  ease  of 
installation.  Compare  maintenance  costs.  Com- 
pare price.  Compare  operating  costs.  If  you  are 
not  firmly  convinced  about  the  superiority  of 
WYLBUR,  try  it  under  our  rental  plan.  One- 
hundred  percent  of  your  rental  payments,  up  to 
a  maximum  of  seven  months,  can  be  applied 
toward  a  perpetual  license. 


3 


WHAT  ARE  THE  HARDWARE  REQUIREMENTS? 


WHAT  ABOUT  INSTALLATION? 


WYLBUR  can  be  installed  on  370  systems  (model 
135  and  larger)  or  plug  compatible  CPUs  under 
OS/MVT,  VSI.  SVS,  MVS  (HASP  or  JES).  A  trans- 
mission control  unit  such  as  the  IBM  270X  or  370X 
is  necessary  for  dial-up  or  remote  terminals.  A  3272 
Control  Unit  is  required  for  locally  attached  3277 
terminals. 

Terminals  supported  include  local  and  remote 
3270-compatible  devices,  2741-compatible  devices 
and  the  expanding  and  inexpensive  variety  of  TTY- 
compatible  terminals  in  either  hard  copy  or  CRT 
versions. 

WHERE  DID  WYLBUR  ORIGINATE? 

WYLBUR  was  developed  by  computer  scientists 
at  Stanford  University's  Center  for  Information 
Processing.  Despite  the  lack  of  any  organized 
marketing  or  distribution  effort  in  the  past,  the 
number  of  installations  using  WYLBUR  has 
grown  to  over  one  hundred  in  the  U.S.,  Canada 
and  Europe.  This  occurred  as  students,  faculty 
and  visitors,  having  once  used  WYLBUR,  spread 
the  word  about  its  powerful  capabilities.  As  a  re- 
sult, requests  for  the  program  came  to  Stanford 
from  a  large  number  of  organizations.  Stanford 
subsequently  licensed  other  educational  institu- 
tions on  a  do-it-yourself  basis  without  providing 
installation,  maintenance  or  other  support. 

In  late  1976,  On-Line  Business  Systems,  Inc., 
concluded  an  agreement  with  Stanford  whereby 
OBS  acquired  the  rights  to  commercially  market 
WYLBUR.  Now,  complete  support  for  WYLBUR, 
including  installation,  training,  documentation, 
enhancements  and  maintenance  service,  is  avail- 
able. 

Development  of  WYLBUR  started  at  Stanford  in 
1967.  OBS  has  been  providing  WYLBUR  service 
from  its  data  center  since  1974.  Consequently, 
WYLBUR  is  a  well  seasoned  product,  having 
been  enhanced,  tuned  and  polished  over  the  years. 

WYLBUR  is  available  under  monthly  or  perma- 
nent license  arrangements. 


Installation  is  short  and  simple.  No  special  hooks 
or  Operating  System  modifications  are  required. 
Installation  options  are  available  for  certain  de- 
faults and  conventions.  User  exits  are  provided  at 
key  processing  points  to  allow  tailoring  by  the 
licensee.  Installation  will  take  about  one  working 
day.  Systems  programmer  training  is  provided  at 
installation  time. 

CAN  YOU  TELL  ME  MORE  ABOUT  OBS? 

On-Line  Business  Systems,  Inc.,  is  a  privately 
held  corporation  formed  in  San  Francisco  in  1969 
to  offer  on-line  transaction  oriented  data  ser- 
vices. It  has  developed  a  multiplicity  of  real-time 
applications  ranging  from  reservations  to  order 
entry  systems.  These  applications  operate  on  an 
IBM  370/158  in  the  OBS  data  center  over  a 
nation-wide  teleprocessing  network. 

In  1974,  OBS  management  set  out  to  find  an  in- 
expensive way  to  bring  the  power  of  the  com- 
puter closer  to  the  development  staff  and  to 
lower  applications  development  costs.  Stanford 
University's  WYLBUR  was  one  of  several  termi- 
nal-oriented systems  studied  and  was  selected  by 
OBS  for  installation.  Since  then,  WYLBUR  has 
had  an  amazing  impact  on  the  efficiency  of  our 
data  center  and  on  the  productivity  of  OBS'  staff 
and  of  the  personnel  of  our  clients  using  the  sys- 
tem. We  are  pleased  and  proud  to  have  the  op- 
portunity to  make  WYLBUR  available  to  many 
new  users. 

HOW  ABOUT  MORE  INFORMATION 
ON  WYLBUR? 

If  you  would  like  more  information  about  WYL- 
BUR, call  us  at  (415)  391-9555  or  write  to: 

On-Line  Business  Systems,  Inc. 

115  Sansome  Street 
San  Francisco,  California  94104 
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EVALUATING  WYLBUR  AND  ALTERNATIVES 


EDITING  POWER 

The  methodology  provided  by  a  product  that  allov/s  a  user  to 
rapidly  locate  and  easily  change  specific   text   items   is  the 
foundation  for  productivity  improvement.     The  Window  Mode  Full 
Screen  Editor  works  hand  in  hand  with  VJYLBUR's  line  range 
concept,    to  make  editing  a  breeze.     The  CONTEXT,   DENSE,  CARD 
and  LONG  display  options  provide  users  with  multi-approach 
editing   tools   for  variable  needs.     The  FSE  v/indow  concept  is 
also   the  perfect  solution  for   reviev/ing  132  column  job  output 
on  an  80  column   terminal.     With  a  little  experience,  your 
programmers  can  minimize  editing   time   thru  the  WYLBUR  DEFINE 
command  and  PF  key  support.     After  v/orking  v/ith  this  pov/erful 
tool,   you  will  be  convinced   there   is  no  better  implementation 
of   full  screen  edit   in  any  program  development/ tex t  editing 
system. 

USABILITY 

WYLBUR  v/as   installed   in  over  100   installations  before   it  was  a 
supported  product.     The  major   reason  for   this  incredible 
popularity  stems   from  WYLBUR' s  ease  of  use.     English  language 
syntax  coupled  v/ith  a  forgiving  command  structure  make  it 
simple  for   users   to  learn.     Although  WYLBUR  offers  a  large 
number  of  com.mands  and  options,    it  is   the  kind  of  system  which 
allows   users   to  be  effective  with  knowledge  of  a  small  subset 
of   the  possible  variations.     This   is  one  of   the  reasons  WYLBUR 
is   fun   to  use--you  can  learn  something  nev/  every  day  and  never 
get   into   trouble  by  experimenting. 

RESPONSE  TIME 

Good   response   time   is  an   important  factor   for  productivity 
improvement.     Poor   response   time   results   in  user  frustration 
and   impatience.     Obviously,    the  better   the  response   time  the 
more  a  user  can  accomplish  in  a  given  amount  of  wall  clock 
time.     Ask  our  competitors  what  good  response   time   is.     Don't  ■ 
be  surprised   if   the  answer   is  10-15   seconds.     Ask  a  VJYLBUR  user 
what  response   time   is  like  and  you  will   find   that  our   users  are 
accustomed   to  1-3   seconds.     This  kind  of   response   is  possible 
even  on  heavily  loaded   systems  because  WYLBUR' s  architecture 
v/as  designed   for  maximum  efficiency.     This  means  excellent 
response   time   is  possible  without  significant   im.pact  on  other 
tasks  competing  for   resources   in   the  same  CPU. 


Editing  power,   usability  and   response  time  are  key  factors  in 
maximizing  productivity.     No  system  does  a  better   job  than  OBS 
WYLBUR  in   these   three  critical  areas.     Of  course,    there  are 
other   things  one  must  consider  v/hen  selecting  a  product  such  as 
WYLBUR.     Here  are  some  other  areas  v;hich  were   important   in  past 
e val ua  ti  ons . 

RESOURCE  CONSUMPTION  • 

Although  hardware  costs  are  decreasing,   system  resource 
requirements  are  still   important.     VJYLEUR  has  always  had  a 
reputation  for   low  overhead  and  although  OBS  has  added  major 
features   to  WYLBUR,   we  haven't  neglected  performance. 
Performance   is  especially  critical  to  good  response  time  and 
also   important  v;hen  the  host  environment   is   in  the  370/135  to 
148     range.     You  will  not  find  any  system  with  features 
comparable   to  WYLBUR  requiring  less  CPU  resources.     Here  are 
the   facts   taken  from  our  own  370/158  Mod  1: 

Peak  Daily  Concurrent 

User  Load  '50 


2  Hours 
18.48  sec/hr 


Total  CPU  Time  per 
Day  including 
all  overhead 


ACCESS  CONTROL  i  . 

Please  refer   to   the  description  of   the  OBS  WYLBUR  Access 
Manager   in   the  Systems  and  Operations  Guide  and   in  the 
Reference  manual.     This  extended  security  feature  provides  an 
excellent  safeguard  against  unauthorized  access   to  datasets  and 
jobs. 

APPLICATION   IN  THE  DATA  CENTER 

Often  neglected   by  our  competitors   (because  most  software 
vendors  have  no  experience   in  running  a  production-oriented 
data  center)    is   the  Operations  department.     OBS  offers  a 
v;orking   adaptation  of  V7YLBUR  capabilites   to  solve  many  of  the 
day-to-day  problems  experienced   in  the  data  center.  The 
enclosed   Introduction   to  OBS  WYLBUR  offers  a  concise 
explanation  and  schematic  configuration  of   the  OBS  Operations 
Support  System   (OSS).      OSS   is  attractive   to  many  data  center 
managers  because   it   is  a  straight- forward ,   easy   to  implement 
production  support  system.      If  OSS   is   implemented  by  your 
organization,    the  data  center   can  provide  additional 
justification   for   acquisition  of  VJYLEUR. 
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USER  GROUP 


An  important  development  for  OBS  WYLBUR  has  been  the 
introduction  of  a  formal  OBS  WYLBUR  User  Group.     Known  as 
COLLECT,   the  group  was  established  during  the  March  1979  SHARE 
Convention  and  is  open  to  all  OBS  WYLBUR  installations.  The 
User  Group  functions  independently  of  OBS  with  an  elected 
steering  committee  and  an  OBS  advisor    (in  a  non-voting 
capacity).     The  group  meets  twice  a  year,  and  through  the 
steering  committee  submits  a  formalized  list  of  requested 
enhancements.     In  addition  to  product  enhancement,   the  user 
interchange  has  resulted  in  the  development  of  resources  such 
as  documentation,   field  tested  Execute  Programs  and  a  user 
profile  available  to  each  installation.     The  profile  identifies 
similar  installation  environments  for  discussion  of  user 
developed  mods,  common  problems  and  new  ideas. 

Consequently,  enhancements  to  OBS  WYLBUR  are  determined  in 
cooperation  with  the  users.     Our  users  have  an  established 
vehicle  in  v/hich  to  approach  their  vendor  with  enhancement 
requests,   constructive  criticism  and  valuable  comments.  You 
will  find  that  OBS   is  sensitive  to  the  needs  of  our 
installations  when  it  comes  to  development  of  the  WYLBUR 
product. 

PRODUCT  SUPPORT 

Currently,   there  are  five  systems  programmers  at  OBS  who  are 
qualified  to  provide  WYLBUR  maintenance  support.     The  WYLBUR 
product  knowledge  at  OBS   is  not  centered  in  one  or  two 
individuals.     Our  system  is  V7ell  documented,  which  allows  us  to 
bring  nev;  people  in  and  make  them  rapidly  productive.     If  you 
call  with  a  problem,  you  can  expect  fast  response  from  a 
qualified  person  who  knov/s  the  product.     This  support  is 
available   24  hours  per  day  through  our  data  center.  Direct 
dial-up  maintenance  support   is  available  if   the  installation's 
Telecommunications  Control  Unit  supports  dial-up  devices. 
Although  rarely  needed,   this  dial-up  access  can  be  very  helpful 
in  diagnosing  and  correcting  problems. 

At  OBS,  v;e  realize  that  the  future  of  our  product  is  dependent 
upon  satisfied  customers.  Our  current  customers  have  received 
major  enhancements  to  V7YLBUR  (Window  Mode  FSE,  Access  Manager, 
DEFIIIE  command,  232  line  length,  etc.)  at  no  additional  cost  to 
them  while  our  competition  generally  offers  new  features  as 
extra  cost  items.  If  you  become  one  of  our  customers,  you  can 
look  forward   to  a  product  which  gets  better  with  age. 


If  there  are  other  areas  important  to  your  evaluation  that  are 
not  discussed  here,  please  let  us  know.     We  urge  you  to  take  a 
hard  look  at  the  areas  that  are  fundamental  to  successful  pro- 
ductivity improvement.     Make  sure  that  you  don't  base  your 
decision  on  a  list  of  superficial  features  which  you  may  not 
need  or  v;hich  have  been  provided  at  the  expense  of  solid 
fundamentals . 

In  summary,   if  you  desire: 

9        A  quality  product  that  will  please  its  users — 

®        Product  support  from  a  substantial  company — 

&        Thoroughly  designed  and  carefully  implemented 
product  improvements — 

d        A  system  v/hich  minimizes  its  use  of  resources — 

©        A  system  which  is  priced  right — 

Then  you  can't  go  wrong  with  OBS  InTYLBUR. 
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TRACK  RECORD  ON  ENHANCEMENTS' 


Our   track  record  speaks  for  itself.     OBS  began  marketing  WYLBUR 
in  January,   1977.     At  that  time,  we  had  a  clean  implementation  of 
WYLBUR  for  SVS/HASP  environments.     During  1977  we  completed  the 
following  enhancements: 

9         Implementation  of  WYLBUR  under  MVS/JES2  without  SCP 
mods. 

o         Implementation  of  TVYLBUR  under  VSI/JESl  without  SCP 
mods. 

o        PAGER,  a  modularized  document  formatting  facility, 
o        Implementation  of  user  exits. 

o        Implementation  of  SYSDEFN,   an  installation  option 
macro.  ^ 

o        User  defined  dataset  naming  conventions. 

o         Profile    (or  LOGON)   Exec  files. 

o        Logical  Tab  support  for  terminals  without  hardware 
tabs . 

o         Basic  Mode  3270   support  via  EXCP  for  local 
terminals . 

3         System  Console  support. 

9         Reductions  in  resource  consumption. 

o        Operations  Support  System   (an  optional  feature  of 
VJYLBUR)  . 

o        Graphics  terminal  support. 
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During  1978,  we  completed  the  following  enhancements: 

o         Implementation  of  WYLBUR  under  OS/MVT  with  or 
without  HASP  and  without  SCP  Mods. 

o        Basic  Mode  3270  support  via  EXCP  for  remote 
terminals. 

9        3284/3286  local  or  remote  printer  support. 

&        Communicating  Mag  Card  typewriter  support. 

o        Implementation  of  dynamic  network  control 

capabilites  and  sophisticated  network  error 
recovery  capabilities. 

©  y  NOTIFY  capability. 

®  ADR  LIBRARIAN  interface. 

©  Window  Mode  Full  Screen  Edit. 

Q  User  defined  Program  Function  Keys  for  3270 's. 

o  System  installation  by  the  user. 

Q        SCRIPT  support  for  total  document  formatting 
capabilities.  ' 

o        User  defined  commands  for  all  terminal  types. 

o        DASD  Access  Manager. 

o        Controlled  volume  selection  on  active  file  recovery. 

o        Simplified  and  streamlined  subsystem  interface  to 
support  userwritten  subsystems  under  WYLBUR' s  TP 
Monitor. 

o        Further  reductions  in  resource  consumption. 

o         ON  ERROR  Command    (  A  "Break  Exit"    for  EXEC  files) . 

o        Active  file  option  for   all  V7YLBUR  SHOVJ  commands. 
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During  1979,  we  completed  the  following  enhancements: 

o        VTAM  Support    (Local,  Remote  Bisynch  &  SDLC 
Protocols) 

o        Alternate  JES2  Interface  providing  increased 
functions 

9        3728  terminal  support   (Models  1-5) 

o         232  line  length 

&        MILTEN  trace  facility 

©        Extended  PF  key  support  through  24 

9         NJE  Support  ^ 

©        PANVALET  Interface 

o        New  User  Guide   including  Full  Screen  Edit  Tutorial 

During  1980,  we  plan  to  continue  an  aggressive  schedule  of 
significant  enhancements.     Some  of  the  proposed  enhancements  are 
listed  belov/: 


o 

JES3  interface 

o 

Dynamic  system  generation 

o 

Implementation  of  DSN  macro  in  Access  Manager 

o 

ACF2  Interface 

o 

User  Security  Exit  at  Dataset  Level 

9 

Exit  for  user  written  commands  • 

Q 

User  Defined  JOB  Statements 

O 

RENAME  Command 

o 

RESAVE  Command 

o 

Dynamic  volume  allocation 

o 

Multiple  commands  per  line 
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9        VSAM  catalog  support 


o        Implement  Window  Mode  Commands  in  Exec  Files 

Our  motivation  to  produce  these  enhancements  is  tempered  with  our 
knov>7ledge  of  the  work  required  to  produce  high  quality  systems. 
In  this  manner,  our  customers  are  assured  that  new  features  will 
not  be  produced  at  the  cost  of  a  stable  and  maintainable  product. 
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Copyr ight 
On -  Line  Business 
AM  Rights 


1980  by 
Systems , 
Reser  ved 


3 r  d  E d  I  t  i  on 
June  1980 

Some  of  what  is  contained  herein  is  based  on 
materials  copyrighted  by  the  Board  of 
Trustees  of  the  Leland  Stanford  Junior 
University  and  reprinted  by  permission.  No 
portion  of  this  document  may  be  reproduced 
in  any  medium  without  the  prior  written 
permission   of   On-line   Business  Systems,  Inc. 


1 


INTRODUCTION  TO  OBS  WYLBUR 


Additional    copies     of      this     manual      may  be 
acquired   by  contacting: 

ON-LINE   BUSINESS  SYSTEMS,  INC. 

1 1 5  Sansome  Street 
San   Francisco,    California  94104 
(415)    39 1  -9555 


INTRODUCTION  TO  OBS  WYLBUR 

TABLE  OF  CONTENTS 


« 

Introduction                                                                                          .    .  .  1 

Hardware-Software  Requirements                        .    .        .    .    ...  .  5 

Func  t  1  ons  and  Facilities        .    ■.    .    ...    .    .    '.    ..   .    .    .    .    ...    .    .  .  6 

Full    Screen  Editing                                   .    .    .    .    .    .    .    ,        .    .    .    .    .  12 

Split   Screen  Editing    .    .  :  .    .    .    .    .    ;    ...    .    .    .    .    .    .    .  16 

Remote   Job   Management    19 

UtilityFunctions      .  .        .    ...  22 

Word   Processing-Document   Formatting                                ..    26 

Execute   Programming                                   .    .    .    .    .    .    .    .    .    .    .    .    .    .  35 

The   Operations  Support   System    41 

Performance  Considerations                                         .    .    .    .'   47 

Security  !    .    .    .   49 

Sess  I  on   Ac  c  oun  t  i  ng    .    .  ■  .    .    .    .    .   53 

Implementation  Requirements      .  ".    .    .    .    .    55 

WYLBUR  Documentation    .    .    .    .    . ■.    .    57 

OBS  WYLBUR  Users  Group                                     .   58 

Training   _     ^    _     _     _     _      ■    60 

Maintenance   AndSupport      '.   61 

Customizing...    ,..-   52 

Summar  y      .......    ,  53 


I 


INTRODUCT I  ON   TO  OBS  WYLBUR 


Introduct ion 


I_NTRCDUCT_[ON 


This  document  provides  a  thorough  overview  of  WYLBUR,  its  functions, 
implementation  requirements,  performance,  documentation  and  the 
support  for  WYLBUR  provided  by  OBS.  It  is  intended  for  use  by 
customers  licensed  to  OBS  WYLBUR,  and  prospective  customers  who  are 
eva I uat i ng  OBS  WYLBUR . 

H j_s^^o£y  .         .  ■        •    .  ■ 

WYLBUR  was  developed  by  computer  scientists  at  the  Stanford 
University  Center  for  Information  Processing.  Despite  the  lack  of 
any  organized  marketing  or  distribution  effort  in  the  past,  the 
number  of  instal  lations  using  WYLBUR  has  grown  to  over  one  hundred  in 
the  US.,  Canada  and  Europe  This  occurred  as  students,  faculty  and 
visitors,  having  once  used  WYLBUR,  spread  the  word  about  its  powerful 
capabilities.  As  a  result,  requests  for  the  program  came  to  Stanford 
from  a  large  number  of  organizations  Stanford  subsequently  I  icensed 
other  educational  institutions  on  a  do-it-yourself  basis  without 
providing    installation,    maintenance   or    other  support. 

In  late  1976,  On-Line  Business  Systems,  Inc.  concluded  an  agreement 
with  Stanford  whereby  OBS  acquired  the  rights  to  commercially  market 
WYLBUR  Now,  complete  support  for  WYLBUR,  including  installation, 
training,  documentation,  enhancements  and  maintenance  service  is 
aval  I  ab  I  e  . 

What    I s  WYLBUR7 


First  and  foremost  a  program  de ve I opmen t  sy s t em ,  WYLBUR  also  provides 
document  formatting  capabilities  and  EDP  production  support 
capabilities  to  OS  and  OS/VS  installations  By  providing  text 
editing,  RJE/RJO,  document  processing,  dataset  utility  functions  and 
even  an  interactive  procedure  language,  WYLBUR  provides  users  with 
open-shop"  access  to  the  computer  without  causing  the  management 
problems  normally  associated  with  an  open-shop  It  offers  "big  shop" 
program  development  capabilities  to  smaller  370  installations  and 
also  offers  a  realistic  vehicle  to  supplement  or  replace  TSO  in 
medium  to  large  installations  experiencing  problems  supporting  the 
resource    requirements   of  TSO. 

F  u  n£ j_j_o  n  s 

Text  Editing  -  Using  English  language  commands,  WYLBUR  offers 
powerful    editing      facilities  In   addition      to   common      line  oriented 

commands  (DELETE,  INSERT,  REPLACE,  MOVE,  COPY)  WylBUR  offers 
sophisticated  Q\ot5'-  commands  for  searching  and/or  changing  specific 
character  strings  Searches  may  be  specified  by  line  number,  text 
content,    column   positions,    absence    of    a    string,      string   occurrence  or 
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any  combination  of  the  above.  Editing  commands  operate  on  an  ACTIVE 
or  working  file  for  each  concurrent  user.  Maximum  ACTIVE  file  size 
IS  variable  but  10,000  lines  of  text  is  a  practical  li'jnit  Maximum 
text      line    length      is   currently     232  -characters  ACTIVE    files  are 

automatically  recovered  in  the  event  of  any  system  or  communication 
linefailure 

WYLBUR  user  datasets  are  standard  OS  datasets,  sequential  or 
partitioned  Space  compression  is  available  at  the  user's  option. 
Datasets  a^e  dynamically  allocated  and  space  accounting  functions 
prevent     excess     disk      space     allocations     by     users  A  read-only 

interface  to  LIBRARIAN  is  provided  to  LIBRARIAN  licensees  A  similar 
interface   to  PANVALET    is  also  provided   to  PANVALET  licensees 

RJE/RJO  -  Users  may  submit  jobs  from  a  terminal  to  run  in  batch  mode. 
Once  submitted,  the  job  may  be  controlled  by  its  owner  (le.,  Held, 
Released,        Cancelled,      Routed,        Purged,      Printed).  When   the  job 

com(^ietes,  the  spooled  output  may  be  reviewed  by  the  user  at  the 
terminal.  All  text  editing  commands  may  be  used  to  search  for  and 
display  desired  job  output  lines.  After  reviewing  spooled  output, 
the   user    may   decide    to   print   or    purge    the   output  listing. 

Dataset  Utilities  -  VTOC  inquiries,  Catalog  inquiries  and  PDS 
d:rector>'  inquiries  are  available  to  users  as  well  as  SCRATCH,  CATLG, 
UNCATLG,  RECATLG  functions  for  "owned"  datasets  Privileged 
functions  are  available  to  allow  certain  users  to  bypass  ownership 
requirements 

Document  Processing  -  Editing  commands  coupled  with  a  special 
interactive  formatting  program  allow:  text  justification  (ragged 
right  or        left/right      justified),  pagination,  centering, 

indentation,  page     numbers,  headings,        footings     and   table  of 

contents  c  index  generation.  Form  letter  generation  with  stop 
code   capability    is  also  available. 

Procedure  Language  -  A  WYLBUR  Execute  Program  is  simply  a  dataset 
containing  one  or  more  WYLBUR  commands  which  may  be  called  as  a  unit 
and  executed  in  a  controlled  sequence.  This  effectively  provides  a 
powerful,  interactive  programming  language.  Functions  available 
include  Terminal  I/O,  String  processing  commands.  External  File 
I/O,  Branching, ^  Branch  and  Link,  XCTL  capability  to  pass  control  to 
subsequent  EXECS,  and  a  pre-processor  that  will  scan  commands  and 
provide  text  substitution  based  on  a  symbolic  parameter  concept. 
Execute  programs  provide  an  excellent  vehicle  for  JCL  or  Source 
conversions.  Computer  Assisted  Instruction,  JCL  creation,  User 
profiles   or    any    low   volume    input    interactive  application. 

Opei-ations  Support  System  -  Available  as  an  optional  feature  of 
WYLBUR.  OSS  offers  automated  production  job  scheduling  and 
submission,  facilities  for  creation,  inquiry,  update  and  reporting  on 
an  on-line  production  job  documentation  library,  automated  job 
restart  facilities,  and  audit  trails  to  facilitate  research  of 
production  problems  OSS  eliminates  card  handling  errors,  provides 
current      documentation    to      the     operations   staff      on     a  daily  basis, 
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simplifies      training   of  new  personnel,        provides     a  production  job 

acceptance  vehicle  and  helps  eliminate  data  center  dependence  on 
"application  experts" 

What   Will    WYLBUR  Do  For  Me  ^ 


In  a  purely  batch  mode  of  operation,  much  of  the  effective, 
productive  time  of  people  is  wasted  waiting  for  results  and  wading 
through    large   volumes   of  printout. 

Programming  time,  and  particularly  program  maintenance  time,  can  be 
dramatically  improved  with  on-line  editing  and  remote  job  management 
capability  Many  tasks  which  previously  took  weeks  or  months  can  be 
completed    in   a   few  days   with    the   right   program  development  tools. 

The  workload  on  the  Operations  department  is  reduced  significantly 
when   WYLBUR      is    installed  Although    the     number    of      jobs  submitted 

generally  increases.  Operations  will  actually  need  to  handle  fewer 
jobs  since  no  input  decks  are  needed  and  much  output  is  never  printed 
because    the    job   output   was   reviewed   at    the   terminal  . 

Less  departmental  interaction  between  Operations  and  Programming  or 
otne''    grouDs   results    in   more   productive   use   of    each   group's  time. 

Users  cari  work  on  one  task  to  its  completion,  or  at  least  to  a 
logica'  breakpoint,  instead  of  being  restrained  by  poor  turnaround. 
This  means  fewer  mistakes  because  of  concentration  on  one  set  of 
problems  It   also     results      in   faster     project     completion  and  an 

earlier    return   on  investment. 

l!i£l£.^£  l^i2.LKin3  ^£1]."-'  I  t  I  ons  ' 

We  all  know  how  tough  it  is  to  find  and  keep  good  technical  talent. 
As  wit^"!  any  job,  the  better  tools  you  provide  your  employees,  the 
better-  job  they  will  do  and  the  more  they  will  enjoy  doing  it  If 
WILBUR  IS  nothing  else,  it  is  incredibly  popular  with  its  users. 
This  IS  usual  1/  because  of  fast  response  time  and  WYLBUR's  ease  of 
use  With  WrLBUR,  your  installation  will  be  a  better  place  for  your 
staff    to  work 
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By   eliminating   card      decks,      reducing   printed   output  '-and   providing  a 

vehicle      for   programers     to     determine      job   status,  you  eliminate 

several  functions  that  required  people  time  (and  thus  manaqement 
timelinthepast. 

I1l£lllim£  B^l£iiL££  Requirements 

Unlike   most   competitive   systems,      WYLBUR  was   designed   for  efficiency 
Through   advanced   system  architecture   and   efficient   code       WYLBUR  will 
cost    less    ,n    terms  of   CPU    time    than   any   competitive   system  supportinq 
a  similar   number    of    concurrent  users. 
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HARDWARE  -  SOFTWARE  REQUIREMENTS 


WYLBUR      is  written      in   Assembler      language     code.        Its  input/output 

routines     use  EXCP-leve!      programming  The     system    (including  its 

built-in  TP  monitor)  requires  one  region/partition  to  run. 
Generally,  all  the  equipment  used  by  WYLBUR  is  already  required  by 
the     operating     system.  Specific     hardware/software  requirements 

f  o  I  low; 

WYLBUR  HARDWARE/SOFTWARE  REOUIREMENTS 


REOU I REMENT 
CPU 


Main   Storage  (minimum 


Operating  Systems 
Sup p or  ted 

Spooling  Systems 
Suppor  ted 


Ter 


m  I  n  a  I  s 


Direct  Access 
Storage  Devices 
(for    WYLBUR  load 
library   and  user 
da  t  ase  t  storage) 

Tape  Drive 

(for     loading  system) 
P  r  inter 

(for  high-speed  listings 
and    job   output  listings) 


TYPE 

IBM  S/370  Mode  I    135  or    larger , 
or   equivalent   compatible  device 

512K  bytes   real  storage 

on   the  CPU    (WYLBUR  requires  a  minimum 

256K   virtual  region) 

OS/MFT,    MVT,    VSl,    VS2    (SVS,  MVS) 
HASP,    JESl,    JES2,  JES3 


2740 ,    274 1 ,    TTY ,    3270  (local 
and   remote),    3278  models  1 
through   5,    or  equivalent 
compatible  devices 

All    IBM-compatible  direct-access 
storage   devices    (2311,  2305, 
2301  ,   2314 ,   3330,   3330  -1  1  ,  3350, 
3340 ,    etc  ) 


2400/3400  series  compatible  tape 
dr  I ves    (9  -  t  r  ack  ) 

1403  (with  TN  -  t  r  a  I n  if  upper  / 
lowercase  printing  required), 
3211,    or    equivalent  devices 
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^  '  '  '  ^  y  You   may  want      to   examine   and   update      the  system 

Functions  catalog,        look    at      PDS     directories,      and  see 

actual  dataset  statistics  such  as  tracks  and 
directory  blocks  used,  record  format,  etc.,  by 
using   WYLBUR  commands. 


INTRODUCTION  TO  OBS  WYLBUR 


Functions  and  Facilities 


Job  Management  For  remote  job  management,  you  use  your  active 
(RJE/RJO)  file   as   a  work    area   for    creating    jobs    (JCL)  and 

then  holding  the  output  of  jobs  'when  they 
complete.  You  may  monitor  jobs  as  they  run  in 
the  central  computer,  and  also  have  WYLBUR 
riotify   you   when   your    jobs  complete. 


Word  To     produce     a   formatted     document  (proposals. 

Processing  contracts,    letters   or    manuals,    for    example)  you 

use  your  ACTIVE  file  as  a  work  area  while  you 
tell  VJYLBUR  how  to  arrange  the  text.  Documents 
can  go  straight  from  your  ACTIVE  file  to  the 
high-speed   printer    when   you   are  ready. 


High-level  You       may       also       use       WYLBUR's  Interactive 

Programming  Programming  Language      to   write     simple  programs 

composed  of  special  WYLBUR  commands,  and  have 
these  programs  converse  with  you  at  the 
terminal,  perhaps  requesting  information  from 
you,        displaying     reports,  updating  files, 

submitting    jobs  automatically,  etc. 

^lii  1  kli«  Us_^nG  WYLBUR^ 

WYLBUR  has  been  designed  for  you  --  to  communicate  with  you  during 
the  terrrina!  sessions,  to  respond  to  your  requests  and  to  ask  you 
questions   when     more    information      is   needed  WYLBUR  commands  have 

short  forms  (abbreviations)  that  make  them  easy  to  use,  an  especially 
nice  feature  for  the  non-typist.  While  signed-on  you  have  a 
one-to-one  relationship  with  the  central  computer.  It  appears  as  if 
you  are  the  only  user  on  the  system.  Everything  you  ask  WYLBUR  to  do 
IS  done  independently  from  anything  else  that  may  be  going  on  within 
the   system  You   may     submit    jobs,        send    files      to    the  high-speed 

printer  and  begin  work  on  something  else  --  with  each  task  executing 
concurrently       Response    times   are   exceptionally  fast. 

WYLBUR  also  protects  your  work.  Should  there  be  any  hardware  or 
software    failure,        your    ACTIVE    file      is   fully   protected  You  will 

never  spend  time  re-entering  lost  text  These  features  help  increase 
your    efficiency   and  productivity. 

i.D.lLZ  ^nd  Edj_j_j_n£ 

Text  entry  simply  means  collecting  information  for  subsequent 
retrieval  Text      editing    is    the     manipulation   and   changes     that  you 

perform  on  that  information  Through  WYLBUR,  you  have  the  computer's 
speed   and   power    at    your    fingertips    for    entering   and   editing  text. 

You  are  connected  to  WYLBUR  through  either  a  hard-copy  or  CRT-type 
terminal  You   enter    text    by   keyinq    the    text    at    the    terminal  Each 

line  o,  text  you  enter  is  numbered  and  displayed  To  make  changes  to 
the    text,      you    reference    line   numbers     or    character    strings,      or  with 
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Window  Mode  Full  Screen  Edit,  you  move  your  cursor  to  a  line  and  type 
in  new  text.  You  can  tell  WYLBUR  whether  or  not  to  display  each 
change   after    it   has   been   made  r,^      :     .  >' 

As  you  become  proficient,  you  can  have  WYLBUR  shorten  all  its 
responses   for    quicker  editing. 

If  you  move  lines  of  text  around  or  insert  new  lines,  WYLBUR  will 
keep    the     original    line     numbers   for    the     remaining   text.  Only  the 

moved   or    inserted   sections   are   renumbered    --   by   decimal  increments. 

What_  Ar_e  ]_he_  Xl^l 

WYLBUR  commands  are   shown    in  uppercase    in   the   following  paragraphs. 
To  begin,    you  need   to  sign-on   to  start   a   terminal    session  on  WYLBUR. 

•  LOGON  tells  WYLBUR   that   you  want    the  sign-on  procedure. 

•  LOGOFF         signals   the  end  of   a  work  session. 

To  enter    text   once  you  are  signed  on,    you   tell    WYLBUR  to: 

•  COLLECT        lines  and  automatically  number  them. 

•  INSERT         single    lines  between   existing  lines. 

To  move    I ines  of    text   around,    you   tel I    WYLBUR  to: 

•  COPY  lines    into     a  new      location  without     disturbing  the 

originals         Lines     to  be  COPIED     may  exist      in  the 
ACTIVE   file  or    in   a  separate  dataset   on  disk. 

•  MOVE  lines   from  one  place    in   the  ACTIVE   file   to  another, 

deleting   the  originals. 

•  REPLACE       existing    lines  with  new  text. 
•DELETE  existinglines. 

To  change  characters  in  the  text  without  replacing  the  entire  line, 
you  can  either  position  the  3270  cursor  on  the  lines  to  be  changed 
and  enter    the  new   text,    or   use  WYLBUR  commands  to: 

•  CHATJGE         one   character    string    to   another    character    string  in 

specific    lines   or    throughout    your    ACTIVE  file, 

•  EDIT  lines  by  having  WYLBUR    list      the    line  and  allow  you 

to    type   only    the   new  characters 

•  MODIFY  lines  using     alteration    techniques  which     allow  you 

to    insert,    delete,    or    replace  characters. 

•  UPDATE         specific    lines     or    full    screens     of    text      lines  via 

FullScreenEdit. 

•  UN PROTECT   a   full    screen   of    text    lines    in   order    to   cursor  edit 

a   section   of    your    ACTIVE  file. 
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To   examine    text    tines   or    get    a  printout    of    your    ACTIVE    file,  you 
tell    WYLBUR  to 

•  REVIEW         lines  by   displaying   specific      lines  or    full  screens 

of    lines    in    the   Full    Screen   Edit  format. 

•  LIST  lines     by     printing     or      displaying      them     at  your 

terminal    or    on    the   high-speed  printer. 
.   PUNCH  your    ACTIVE   file   to  cards. 

There  are  many  options  available  which  may  be  set  for  a  terminal 
session,  and  most  of  these  options  have  a  default  value  assigned  by 
WYLBUR  . 

Options  are  defined  with  the  SET  command  and  their  values  displayed 
with   the  SHOW  command: 


.  TERSE/VERBOSE 


TABS 


governs  the  verbosity  of  WYLBUR  prompts  and 
messages  . 

can  be  set  or  displayed,  even  if  your 
terminal  does  not  have  a  hardware  TAB 
feature 


LENGTH 


CASE 

UPPER/UPLOW 


BACK 


DELTA 


is  the  maximum  number  of  characters  allowed 
on  a    line  before  a  warning    is  issued. 

CASE  defaults  to  upper  only,  but  can  be  set 
to  upper   and    lower    (UPLOW)  . 

allows  you  to  use  an  uppercase  backspace  to 
enter  a  backspace  character  into  your  text, 
and  a  lowercase  backspace  to  erase  the 
previous  character. 

IS  the  increment  WYLBUR  uses  in  calculating 
line  numbers. 


FASTL IST/ 
SLOWL IST 


tells  WYLBUR  whether  or  not  to  use  terminal 
tabs  to  speed  terminal  listings  on  hardcopy 
devices. 


RETRY 


SHORT  I  rJOSHORT 


sets  the  mode  in  which  WYLBUR  will  allow  you 
to  retry  any  failing  command  without  having 
to   type    It    in  again. 

determines  whether  or  not  I  ine  number 
(immediate)  commands  are  to  be  verified 
prior      to      execution,  thereby  preventing 

accidental  deletion  or  replacement  of 
existing    line(s)    in    the   ACTIVE  file. 
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Ex_arn2^J_e  of_  En_t_]^y  and  E d_i__t_1113. 


This  example  shows  a  sign-on  procedure  and  a  paragraph  entered  and 
corrected.  In    this     and   all      the   following     examples,      the  symbol 

'(ATTN)'  IS  used  to  indicate  the  appropriate  break  feature  on  a 
terminal.  On  2741  terminals,  the  key  is  an  'Attention'  key.  On  TTY 
terminals,  the  key  is  a  'Break'  key.  On  3270  terminals,  the  key  is  a 
'PAl  '    key  . 


OBS  WYLBUR  REL  5   1  TERMINAL 

USERID'  ozusr 

KEYWORD^ 

ACCT  NO'  2550A22 

ACCT    IN  EFFECT  :  2550A2200 


TRMROOM  4    16  53:14  05/0 1  /80 


COMMAND' 
COMMAND' 

1  . 

2. 

3. 

4  . 

5  . 

6  . 

7  . 

8  . 

COMMAND' 
1  . 

COMMAND ' 
1  .  1 
1  2 
1  3 
1  .  4 

COMMAND' 
2 

COMMAND' 


1  .  2 

1  3 

2  . 
3. 

4  . 

5  . 
6. 
7  . 
8 

COMMAND' 


set 
CO  I 


up  I  OW 

ec  t 


wy  I  bur    ' s  easy  t 
The   comands  are 
to   remember  and 
know   a   million  c 
productive  right 
IS   very   good  and 
get   more   done  in 
(ATTN)  *** 
change    'wylbur'  to 
WYLBUR    IS   easy  to 
collect  1.1 
'   A  powerful    set  o 
'   enter    and   edit  t 
'   dat  ase  t  s  ,    and   r  u 
'    (ATTN)  *** 
change    'm'    to  'mm' 
The  commands  are 
list 

WYLBUR  IS  easy  t 
A  powerful  set  o 
enter  and  edit  t 
datasets,  and  ru 
The  commands  are 
to  remember  and 
know  a  million  c 
productive  right 
IS  very  good  and 
get  more  done  in 
( ATTN  )    *  *  * 


0  use  . 
easy 

1  don't   need  to 
ommands    in   order    to  be 

away.      The   response  time 
1    think    I   can  therefore 
I e s s   t  I  me 

' WYLBUR ■ 
use  . 

f    commands   al lows  me  to 
ext,    save  and  retrieve 
n    jobs  remotely. 

I  n  2 

easy  ^ 

0  use. 

f   commands   allows  me  to 
ext,    save  and  retrieve 
n    jobs  remotely, 
easy 

1  don't   need  to 
ommands    in   order    to  be 

away.      The   response  time 
I    think    I    can  therefore 
less  time 
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Explanation: 

After  the  sign-on  procedure  is  completed,  the  SET  UPL'OW  command  tells 
WYLBUR  that  upper  and  lower  case  characters  will  be  entered. 
Otherwise,  WYLBUR  automatically  converts  all  alphabetic  characters  to 
upper    case . 

COLLECT    IS    the   command   used    to    tell    WYLBUR   you   want    to   create    text  . 

WYLBUR  responds  to  the  COLLECT  command  with  I ine  number  prompts.  As 
each  line  number  is  prompted,  WYLBUR  waits  for  you  to  type  text. 
When  you  strike  a  carriage  return  WYLBUR  prompts  with  the  next  line 
number,  and  so  on  With  Window  Mode  FSE,  a  full  screen  of  lines  may 
be    typed  before    the   ENTER  key    is  pressed. 

After  text  entry  is  complete,  an  (ATTN)  notifies  WYLBUR  to  stop 
collecting  and  return  to  COMMAND  mode  Three  asterisks  (***)  are 
printed   whenever    the    (ATTN)    key    is   struck    in   COLLECT  mode. 

A  lowercase  string  is  to  be  changed  to  an  uppercase  string  wherever 
it   appears    in   the  ACTIVE  file. 

Multiple    lines   are    to   be    inserted   after    line  1. 

One  particular  character  string  ('m')  is  to  be  changed  to  another 
('rm')    in    line  2 

LIST   tells   WYLBUR   to   p r  i n t /d i sp I  ay    lines   from  your  ACTIVE 
may   also      list    by    line   numbers     or    by   character  strings 
LIST    '  ABC  '    or   LIST   2/5 )  , 


file  You 
( E  x  amp  I  e  : 
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FULL  SCREEN  ED  i  T I NG 


In  general,  Full  Screen  Editing  (FSE)  is  the  ability  to  modify  any 
character  or  group  of  characters  displayed  on  a  Video  Display 
Terminal  (VDT)  simply  by  positioning  the  VDT ' s  cursor  at  the  position 
you  wish  to  modify  and  typing  over  the  existing  text.  Special 
function  keys  on  the  VDT  further  simplify  editing  because  they  allow 
the  user  to  insert  a  variable  number  of  characters  between  existing 
characters,  delete  existing  characters,  erase  entire  lines  of  text 
from  the  point  at  which  the  cursor  is  positioned  and  rapidly  move  the 
cursor  to  any  desired  positon  on  the  screen.  This  capability  is 
especially  valuable  because  much  editing  is  accomplished  utilizing 
the  intelligence  built  into  the  VDT  rather  than  requiring  program 
logic  and  user-program  interaction.  The  major  benefits  accruing  from 
the  utilization  of   FSE  are. 

Increased  user  productivity  -  Editing  is  much  faster 
because  there  is  less  typing  required  and  less  interaction 
with  the  editing  program.  Terminal  I/O  is  only  required  to 
transmit  full  screens  of  text  updates  rather  than  single 
lines. 

Since  I/O  is  reduced,  the  system  can  provide  even  better 
response  time  to  more  users.  Overhead  is  reduced  and  the 
system  will    require   fewer   CPU  resources. 

Many  systems  in  today's  marketplace  offer  an  FSE  feature.  There  are 
a  number  of  features  provided  by  WYLBUR's  Window  Mode  FSE  that  are 
unique  and  have  accounted  for  the  overwhelming  acceptance  it  has 
receivedto-date. 

The   following   summarizes   the    important  features; 

WYLBUR's  3270  support  consists  of  B  a sic  mode  and  Window  mode  display 
formats.  In  Basic  mode,  commands  and  responses  proceed  down  the 
screen  to  I ine  23,  then  resume  at  the  top  of  the  screen.  A  command 
input  area  of  3  blank  lines  serves  as  a  separator  delimiting  the  most 
recent      response      from     previous     displays.  When      text      lines  are 

displayed  in  Basic  mode  (via  the  LIST  command,  for  example),  each 
text  line  is  displayed  on  two  screen  lines  as  explained  below  under 
the   window  display   option  LONG. 

In  general,  it  is  unnecesary  to  issue  a  command  to  switch  in  or  out 
of     Window  Mode  The   Window      is      the   default      display    for  certain 

commands  while   other    commands   will    switch    the   screen    to   Basic  Mode. 

Switching    In   and  Out    of    Window  Mode 

Two  commands,  REVIEW  and  UPDATE  provide  full  screen  display 
and     display/edit      capabilities.        These     are     Window  Mode 
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commands. 

The  COLLECT  and  INSERT  commands  default  to  Window  Mode 
operation  These     commands,  ,  however,        provide  options 

(NOWINDOW)      that    allow   the   user      to    indicate    that   he  wishes 
them   to   operate    in   Basic  Mode 

The  DELETE,  CHANGE,  MOVE,  COPY,  LINE  NUMBER,  USE,  and  FETCH 
commands  work  in  conjuncton  with  Window  Mode.  Commands 
which  replace  the  ACTIVE  file  (USE,  FETCH)  will  also  cause 
the  new  ACTIVE  file  to  be  displayed  starting  with  its  first 
line  if  a  Window  existed  when  the  command  was  invoked.  The 
line  oriented  editing  commands  will  cause  the  Window  to  be 
re-displayed  centered  around  the  last  ACTIVE  file  line 
changed   by    the  command. 

The  LIST,  EDIT  and  MODIFY  commands  are  Basic  Mode  commands 
and  will  force  the  screen  into  Basic  Mode  when  invoked. 
These  commands  are  not  recommended  if  a  3270  terminal  is  in 
use  because  the  REVIEW  and  UPDATE  commands  provide  much 
more    flexibility   and   better  productivity. 

Al  I  other  commands  are  Basic  Mode  commands,  but  mode 
switching  from  Window  Mode  to  Basic  Mode  is  done  only  when 
the  command  entered  requires  more  than  a  single  response 
line   or    is   otherwise   unsuited    to   operate    in   Window  Mode. 

Any  switch   to     Basic  Mode  causes   the   screen     to  be  cleared. 

Command   options   are   provided    to     allow   the   user  to  restrict 

operating   modes   to   Basic   Mode   either    in   general  or  on   a  per 
command  basis. 

TheWindowModeScreen 

GeneralLayout 

•  Line    1    -   prompt    and   command    input  area. 

•  Line   2    -    response,    if    any,    to    last  command. 

•  Line  3  contains  a  column  scale  that  always  corresponds  to  the 
text   displayed  below. 

Line   4-23     constitute    the   ACTIVE    file   window  and     are   used  to 
display   and   update    lines   of    text    from   the   ACTIVE  file. 

Line   24      is   used,      as    in   Basic   Mode,        to   signal  asynchronous 
events   and    to   contain    the   range-pending    'MORE    ..'  indicator. 

The   Active   File  Window 

The   ACTIVE    file   window    (screen      lines   4    through   23)  consists 
of    line   number    fields   and    text      fields  The    line   number  fields 

are   protected  The    text    fields     are   protected     or  unprotected 
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depending  on  the  command  that  produced  the  display.  The  line 
number  fields  are  omitted  for  commands  specified  with  the 
unnumbered   option.      Screen    lines   not   used   are  protected. 

•  Any  change  to  a  text  field  in  the  window  is  applied  to  the 
ACTIVE  file  when  ENTER  is  pressed,  provided  there  has  been  no 
interveningPAl. 

•  The  line  number  fields  are  made  as  small  as  possible  while 
stiM  maintaining  digit  alignment  of  line  numbers  and  column 
alignment  of  text  fields.  This  allows  maximum  text  line  length 
in   the  window  display. 

•  The  portion  of  the  text  lines  displayed  depends  on  the 
current  column  setting  of  the  ACTIVE  file  window  (see  tfie  WINDOW 
and  SET  WINDOW  commands).  The  scale  line  (screen  line  3) 
identifies  columns  shown  in  the  text  areas  of  the  ACTIVE  file 
window. 


•  Padding  characters  for  window  text  fields 
null  characters.  The  user  determines  this 
command . 

•  W  i  n  d  o  w  F  o  r  ma  t  s  . 

Three   different      screen   window   formats     are  supported 
Each   of    these   formats   allow     for    the   display   of  ACTIVE 
file      lines      in     a   slightly     different      form.  These 
formats     are   designated     as  CARD.       LONG  and  STANDARD 
Window  formats 


are  either  blank  or 
with   the  SET  W I NDOW 


1)  STANDARD  Window  format  allows  one  screen  line  for 
each  ACTIVE  file  line.  This  format  allows  for  a 
display  of  a  maximum  of  79  characters  per  line 
with  the  UNNUMBERED  display  option  in  effect  and 
from  70  to  77  characters  per  line  otherwise.  Only 
those  columns  indicated  by  the  current  window 
setting   are  displayed. 

CARD  format  requires  two  screen  lines  per  ACTIVE 
file  line  displayed.  The  WYLBUR  line  number  is 
displayed  on  the  screen  line  immediately 
preceeding     the     applicable     text.  This  format 

allows  for  display  of  a  full  80  characters  per 
ACTIVE  file  line  without  splitting  the  text  onto 
two   screen  lines. 

3)  LONG  format  also  requires  two  screen  lines  per 
ACTIVE    file    line  displayed  This  display  format 

allows  the  display  of  a  full  133  character  line 
With  either  the  NUMBERED  or  UNNUMBERED  options. 
The  text  field  wraps  from  the  initial  line  of  its 
display   onto    the   following  line. 


2  ) 
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The  SET  WINDOW  command  allows  the  user  to  select  the  Window  format 
preferred.  ..  i 

C  0  n  s  j_d  e_£a_t_j_o  n  s  F  o     Use  \ 

The  Window  is  always  representative  of  the  contents  of  the  ACTIVE 
file.  The  only  point  at  which  the  Window  display  differs  from  ACTIVE 
file  content  is  when  the  user  is  cursor  editing  the  screen,  prior  to 
pressing  ENTER-  When   any   command   which     alters   the   ACTIVE      file  is 

processed,  the  Window  is  reformatted  either  to  continue  with  the 
specified  command   range   or    to  display   the  changed  ACTIVE  file. 

When  more  than  a  single  Window 
displayed  to  complete  a  command, 
placed    into    line  24. 


full      of      lines  must  be 
a    ' MORE  .  .  .  '      message  is 


Pressing  PAl  wi  I  I  break  the  range  of  a  command  and  cause 
all  modifications  of  the  current  ACTIVE  file  window  to  be 
ignored.  Current  lines  are  re-displayed  to  insure  that  the 
window  remains  representative  of  the  contents  of  the  ACTIVE 
file. 

The  current  command  is  left  on  the  command  prompt  I  ine 
unti I  the  command  has  completed  or  been  interrupted,  at 
which  tine  the  command  prompt  is  re-issued  with  a  command 
field    filled  per    the   FILLER  option. 

Any  modification  of  the  current  command  has  the  following 
eMectswhenENTER  ispressed; 

modifications     to      text      in      the     ACTIVE  file 
window  are   applied   to   the   ACTIVE  file. 

•  the   current    command    is   then  aborted. 

•  the   modified   command    is  initiated. 


NOTE  The  WINDOW  LEFT,  RIGHT  and  COLUMN  commands  are  unusual  in  that 
they  do  not  abort  the  current  command,  but  merel'y  move  the  ACTIVE 
file  window  so  that  unseen  columns  of  current  lines  may  be  seen  or 
modified  without  affecting  the  completion  of  the  current  command 
range 

Types   of   Window  Displays 
^2.Ql£:ll^3l  D_i_s2^_l_a>^s  . 

WYLBUR   uses      the    foil  owing      sequence   of      logic    in      order  to 
display   a   range   of    lines    in  CONTEXT. 


Th, 


first    line   within    the   command's   range    is  found 


^'      ^"^''^    iine   along   with   up    to    three   preceeding   ACTIVE  file 
lines   are   displayed   on    the     screen    (provided   such  lines 
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exist). 

3)  The  remainder  of  the  ACTIVE  file  window  is  filled  with 
subsequent,    contiguous   ACTIVE    file  lines. 

4)  AM  lines  in  the  Window  that  are  also  designated  by  the 
range   are   displayed    in   bright  intensity. 

5)  If  the  command  range  requires  continuation  onto 
subsequent  screens,  the  next  I ine  of  the  range  that  is 
not  currently  displayed  is  found  and  displayed  with  up 
to    three   preceeding   ACTIVE   file  lines. 

D e n  s e_  D_i_S2^J_a y  s  .  ,  ■ 

Dense  displays  consist  of  only  those  I  ines  in  the  command's 
range. 

Command  options  are  provided  to  allow  the  user  to  select 
display    type    in   general    and   on   a  per    command  basis. 

Sp  I  I  t   Sc  r  een  Ed  I  t  I  ng 


Window  Mode  FSE  provides  the  ability  to  display  separate  areas  of  the 
ACTIVE     file   on     a     single   screen.  If    for      example,        the   user  is 

reviewing  compiler  output,  he  may  wish  to  display  the  diagnostic 
messages  while  also  examining  the  associated  source  listing.  The 
number  of  lines  to  be  displayed  in  each  screen  portion  is  totally 
flexible   as    long   as   the   sum  does  not    exceed  20. 

If  for  example,  diagnostics  began  on  ACTIVE  file  line  number  62  and 
the   source    listing  began   at    line   number    153,    the  command: 

REVIEW  62(5)  ,    153( 15) 

would  display  five  lines  of  diagnostics  and  15  lines  of  compiler 
output  on  a  single  screen.  To  page  through  the  file(s)  the  user 
would  simply  modify  the  starting  line  number  (62  and  153  in  this 
example)   and  press  ENTER. 

The  DEFINE  command  can  also  be  used  to  establish  Program  Function  Key 
values  The  user  can  therefore  DEFINE  a  PFk  to  display  diagnostic 
information  ( o a  certain  group  of  lines  from  a  storage  dump,  for 
instance)  any  time  the  PFK  is  pressed.  This  can  be  very  helpful  when 
trying  to  debug  those  "unstructured"  programs  as  the  user  can  easily 
bounce"    back    and   forth   between   different    areas    in    the   ACTIVE  file. 


M 


.sc  e_^_[an  eou  s  Considerations 


Modification  of  lines  containing  non  -  r ep r esen t ab  I  e  characters  is  not 
allowed  using  Window  Mode  This  is  to  prevent  inadvertent  loss  or 
translation     of      such     characters  Window      lines     containing  such 
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ci-ia'-acters  have  PROTECT  and  SKIP  attributes,  their  line  numbers  are 
hiohlig^ted,  a^a  an  explanatory  warning  message  is  included  on  screen 
line  2  rvlon-representable  characters  may  be  modified  using  the 
CHANGE,    MODIFY   or   EDIT  commands. 


Window  Command  Synopsis 

To  use    the   Full    Screen   Edit    feature,    you  te 
.   SET  WINDOW 


WYLBUR  to 


SHOW  WINDOW 

WINDOW  UP/DOWN 
PAGE  BACK/FORWARD 

WINDOW  LEFT/RIGHT 

WINDOW  COLUMN 

REVIEW 

UPDATE 
DEF INE 


UNPROTECT 


COLLECT 


SERT 


to  alter  one  or  more  of  the  default  window 
options  until  further  notice.  Options 
include  FORMAT  (STANDARD,  CARD,  LONG). 
DISPLAY  (CONTEXT,  DENSE),  FILLER  (NULL, 
BLANK  )   and  PAGE  S I ZE  . 


to  display 
OPT  IONS  . 


the  current 


default  WINDOW 


these  synonomous  commands  shift  the  display 
backward  or    forward  one  page. 

shift    the   window  sideways,    one  page. 

specifies  the  text  column  in  which  you  want 
the   display   to  begin. 

the  ACTIVE  file  in  window  format.  Similar 
to  LIST,    ACTIVE   file    lines  are  protected. 

the  ACTIVE   file  using  Window  Mode  FSE  . 

a  value  for  up  to  24  Program  Function  Keys. 
Provision  is  made  for  the  user  to  allow  for 
a  variable  to  be  substituted  into  the 
expanded  command  before  it  is  passed  to 
WYLBUR   for  execution. 

the  current  screen  so  you  can  edit  it.  This 
IS  the  most  useful  when  you  are  REVIEWing 
and   spot    something    that    needs  fixing 

lines      in      your    ACTIVE      file     by  displaying 

empty    lines    for    you    to    type    into  ENTER  is 

pressed     onlyonce     per      page     of  lines  and 

unused  lines  are  discarded  before  the  screen 
IS  re-displayed. 

single      lines   between     existing    lines  while 

displaying   surrounding   contextual  lines. 
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•  DELETE  line   from   the  ACTIVE   file  and   re-display  the 

window. 

•  CHANGE  character  'strings     or    specific      text  columns 

to  a  specified  string  and  re-display  the 
window, 

•COPY  lines   fromone     place    in    the   ACTIVE     file  or 

from  an  externa''  dataset  to  a  specified 
place  in  the  ACTIVE  file  and  re-display  the 
window  showing  the  lines  in  their  new 
location. 

•MOVE  .  lines   fromone     place    in   the   ACTIVE     file  to 

another  and  re-display  the  window  showing 
the    lines    in    their    new  location. 
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REMOTE   JOB  MANAGEMENT 


Remote  job  management  lets  you  submit  batch  jobs  from  a  terminal 
connected  to  the  central  computer.  You  can  track  the  status  of  jobs 
from  the  terminal,  and  you  can  fetch  job  output  and  revieu  it  at  the 
terminal. 

You  use  your  ACTIVE  file  as  a  work  area  for  composing  your  job  -- 
JCL,  source  code,  and  input  data  if  necessary  The  job  can  be 
entered  into  the  ACTIVE  file  with  the  COLLECT  command,  or  built  by 
using  one  o^  more  permanent  files  Then,  using  a  WYLBUR  command,  you 
submit    your      job    to    the     central    computer.  Any    job   you     can  submit 

through  conventional  batch  methods  can  be  submitted  remotely  with 
WYLBUR . 

You  need  no  special  JCL,  no  JCL  changes  in  existing  jobs  or  extra  job 
steps    to   submit    the    job   and   fetch    it    remotely  In   operating  systems 

utilizing  JESi  or  JES3,  it  may  be  more  expedient  to  modify  your 
SYSOUT  DD  statements  to  refer  to  a  special  SYSOUT  Class  in  order  to 
retrieve    job   output   at    the   terminal  WYLBUR   can   assign    jobnames  for 

you    that      consist    of      your    USERID   and     a   suffix  WYLBUR  constructs 

jobnames    m    this   manner    to   help    identify    job  ownership. 

When  you  want  to  look  at  job  output,  you  use  a  WYLBUR  Command  to 
retrieve  the  output  into  your  ACTIVE  file.  All  WYLBUR  text  handling 
commands  can  then  be  used  to  examine  the  output.  You  may  FETCH  all 
or  pa''!  of  your  job  output  as  many  times  as  you  want.  You  may  also 
direct  output  to  other  devices  for  printing  or  remove  (PURGE)  it  from 
the  system 

To   use    the   remote    job   management    facility,    you    tell    WYLBUR  to: 

•  RU?J  a    job   by   submitting   all    or    part    of    the   ACTIVE    file  to 

the   computer's    input  queue 

•  LOCATE       one   or    more    jobs   and   display    their    status  at  the 

terminal. 

•  FETCH         all    or   part   of   a    job's  output    into   the  ACTIVE   file  for 

ex  am  mat  ion 

•  PRlfiT  the   output    of    a    job   on   a  high   speed   printer,    and  thus 

release    it    from   the  system 

•  PURGE         a    job's   output    when    it    is   not   needed,    instead  of 

printingit 

•  CANCEL        executing    jobs   and    remove    them    from    the  system 

•  HOLD  a    job   by   having    it   placed    in   hold  status 

'    PpUTE  the   output    of    a    job    to   a  particular    output  destination. 

•  RELEASE     a    job    that   was  placed    in  a  hold  status. 
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Example  of   Remote   Job  Management 

This  example  shows  the  process  involved  in  creating  JCL  for  a  job  and 
using  WYLBUR  to  submit  it.  The  job  will  be  created,  run,  and  fetched 
for  examination. 

COMMAND?  collect 


1  . 

7 

// 

JOB 

2  . 

? 

// 

EXEC 

PGM=  IEFBR14  '       :  /:  '  ■ 

3 

? 

//SYSPR 

INT  DD 

SYSOUT=A 

4 

7 

//DDI 

DD 

DSN^TEST  DATAL 1B,DISP= 

(NEW,CATLG) , 

5  . 

-? 

// 

UN  1  T  =  3330 , DCB= (RECFM  =  U 

,LRECL=3156, 

6 

? 

// 

BLKS1ZE=3156,DS0RG=P0) 

, VOL-SER=WYL001 

7  . 

? 

// 

SPACE= (TRK, ( 19, ,9) ) 

8  . 

7 

(ATTN  ) 

«  « 

COMMAND?  run  classes   fetch  ... 

JOB   1073  OZUSR053  SUBMITTED 

COMMAND?  locate  ■ 

JOB   1073  OZUSR053  AW  FETCH     .       '  ^ 

COMMAND?  fetch   *  , 

OK   TO  CLEAR?  OK 

COMMAND?  list    'cond  code' 

10  1EF1421   OZUSR053   -  STEP  WAS  EXECUTED   -  COND  CODE  0000 

COMMAND?  purge  * 

OK  ■  -    >  ' 
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Explanation: 

The  COLLECT  command  is  issued  in  order  to  build  JCL  ,for  a  job  to  be 
run.  , 

The  RUN  command  tells  WYLBUR  to  submit  the  ACTIVE  file  to  the  central 
computer's  input  queue.  The  'FETCH'  parameter  on  the  RUN  command 
tells  WYLBUR   to  hold   the    job  output    for    retrieval    at    the  terminal. 

After  the  RUN  command  is  issued,  WYLBUR  shows  you  the  jobname  and 
number  A  LOCATE  command  causes  WYLBUR  to  locate  al I  your  jobs  in 
the  system,  and  display  their  status.  When  a  job  is  'AW  FETCH'  it 
has  been   run   and   may   be   retrieved   at    the  terminal. 


The  FETCH  command  retrieves  job  output  into  your  ACTIVE  file.  '*' 
refers  to  the  last  job  you  submitted.  FETCH  without  additional 
parameters  tells  WYLBUR  to  bring  in  all  the  output  for  the  job, 
although  you  can  select  JCL,  job  log,  or  dd  statement  output 
individually  by    issuing   other   parameters.  "  ' 

Job  output  is  brought  into  the  ACTIVE  file.  Since  the  job  input  was 
still    there,    WYLBUR  asked   for   permission   to  clear    the  ACTIVE  file. 

Once  job  output  is  in  your  ACTIVE  file,  you  can  look  at  all  of  it 
with  a  LIST  or  REVIEW  command,  or  you  can  list  only  the  important 
lines  by    telling   WYLBUR   to    list    lines   containing   certain  strings. 

Fetching    job   output   does  not   destroy    it.  You   may  print   or    purge  it 

as  necessar  y .  ... 
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UTILITY  FUNCT  1  ONS 


When  you  save  or   scratch  disk   datasets,    update   the  system  catalog,  or 
compress  partitioned   data   sets,    you   are   performing  utility  functions 
WYLBUR   allows     you    to     do    these   functions     on-line   by     simply  issuing 
WYLBUR  commands  Because   WYLBUR    is     a  privileged   program,        it  can 

directly  access  and  modify  the  system  catalog,  show  you  entries  in  a 
PDS  directory,  list  any  or  all  of  the  dataset  names  on  a  particular 
volume,  as  well  as  many  other  timesaving  functions.  You  save  time  by 
performing  these  functions  on-line  rather  than  running  a  series  of 
utilities    to   get   or   change    the   same  information. 


WYLBUR  dataset  names  usually  conform  to  the  standard  structure  shown 
below  Naming     conventions       can       be       customized     for  special 

requirements.  For      a     detailed      look      at      installation  controlled 

variables,    refer    to   the   "CUSTOMIZING"    section  of    this  manual. 

WYL.  (group),  (initials),  (prefix) 


user 
group  identif 
standard  WYLBUR  h 


dataset  prefix 
dent  I  f  icat  ion 
cation 

gh-level  index 


WYLBUR  dataset  names  are  qualified  in  this  manner  for  a  number  of 
reasons: 

1.  All  WYLBUR  datasets  are  easily  identified  by  the  index  'WYL'. 
WYLBUR  can  also  find  its  data  sets  faster  when  the  'WYL'  datasets 
are  listed  in  a  CVOL  connected  to  the  system  catalog.  This  helps 
reduce   response    time   and  overhead. 


All  WYLBUR  datasets  belonging  to  a  particular  group 
identified  by  the  group  qualifier.  That  makes  it  easy 
management    or    the   operations   staff    to  monitor    disk  usage. 


All      WYLBUR     datasets  belonging 
identified   by   the   user's  initials 


to  a     particular     user  can 


ar  e 
for 


be 


4.  The  fourth  qualifier,  prefix,  allows  you  to  select  a  descriptive 
name  for  your  datasets  in  addition  to  the  WYLBUR  index,  group, 
and  user    qua  I  i  f  i er  s . 

When  datasets  are  allocated  in  this  manner,  you  can  let  WYLBUR  supply 
the     qualifiers       when     accessing       datasets.  Instead       of  typing 

f u  II  y -qua  I  1  f  I ed  dataset  names  in  WYLBUR  utility  function  commands, 
you  need  only  specify  a  prefix  or  member  name.  WYLBUR  builds  the 
rest  of  the  qualifiers  using  the  high-level  index,  signed-on  group, 
initials  Of  course,  any  or  all  of  the  qualifiers  can  be 
overridden    if      you   should   want    to     access   some   other    user      or  group's 
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datasets,  or  non  - WYLBUR  datasets.  Using  WYLBUR  conventions  for 
dataset  names  lets  you  type  less  which  in  turn  makes  your  terminal 
session   more  productive. 

What   Are    the   Utility   Function  Commands' 

To  manage  datasets  on  disk,    you   tell    WYLBUR  to: 

.   SAVE  your   ACTIVE   file  as  a  disk    dataset   or   PDS  member. 


•  SCRATCH         datasets   or      members  by  removing    them     from  disk 

storage  . 

•  USE                 a     dataset   by     bringing  a     copy  of      it    into  your 

ACTIVE   file   for   examination  or    editing  purposes. 

•  CATLG             datasets  by  adding   them  to   the  system  catalog. 

•  UNCATLG         datasets     by       removing  them     from       the  system 

catalog,  , 


RECATLG         datasets  by  changing   their      volume  pointer    in  the 
s y  s  t  e m  c  a  t  a  I  o g  ■ 

CONDENSE       a  PDS  by   running   a  compress  utility. 


To  look  at  the  catalog,  dataset  statistics  (VTOC  information)  or  PDS 
directories   you    tell    WYLBUR   to  SHOW: 

•   CATALOG         to     examine     the  system     catalog     for  particular 
entries 


.  DSNAMES  to  list  all  the  datasets  and  statistics  on  a 
certain  volume  or  only  those  datasets  that 
conform   to   a  certain  pattern. 

•  DIRECTORY     to    list     any  portion  or   all      of    the  entries      in  a 

PDS  directory. 

•  S^ACE  to     determine     the     amount   of     free     space     on  a 

volume,  or  the  space  limits  and  current  status 
for    a  given  user. 
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Example   of    Utility  Functions. 


This  example  shows  a  sign-on  procedure,  and  dataset  members  being 
SAVEd  and  SCRATCHed 

OBS  WYLBUR/MVS  REL  5   1    TERMINAL    15:28:48  05/01/80  , 

USER    1 ozusr 
KEYWORD' 

ACCTNO'7309bOO  ^  .  ' 

ACCTNO   IN  EFFECT:    7309b00000  V 
COMMAND?   show  d i r 
WYL .OZ . USR  .L  IB 

COMPILE  !  ■ 

DEMEXEC2 

DEMOEXEC 

EXEC2  - 

EXEC3 

LOGON 

COMMAND  ?   use   #comp il e  ■  '  , 

COMMAND"^   cha    'member'    to    'mypgm'  ^* 

2.  //JSOlO  EXEC  WUNPRESS , GrOZ , I =U5R , N=MYPGM  , 

6.  NAME  MYPGM(R) 

COMMAND?   save  #compil2  '  - 

MEMBER  C0MPIL2  SAVED   IN  WYL . OZ . USR . L 1 B  '     .  ^ 

COMMAND?   scratch  ^compile 

MEMBER  COMPILE  SCRATCHED  FROM  WYL , OZ . USR  L  I  B 
COMMAND?   show  dsn    like  Sobsa.cost   on  cat   all  '■ 
USER12 

OBSA  COST   --    1   of    19  TRKS   --    IS,   FB/24/3240/4    --  CR:  08/11/76 

COMMAND?   show  catig   for  $obsa. 

OBSA 

AUD I T    -   ON  SYS504  '  ■  " 

BILLJES   -  ON  USER  12 

B 1 58   -    I NDEX  ' :  :    ■  • 

CDETA  I L    -   ON  SYS504  /  ;  .     •  > 

COST   -  ON  USER12  ,    . " 

DETA  IL    -   ON  SYS504  , 

DETA ILWK    -  GDG  6  GENS 

DRECYCLE    -   ON  SYS504 

DSMFTLMS    -   ON  SYS504 

DTAPESUM   -   GDG  3  OF  1 

COMMAND?   sho  cat    for   $obsa  detaiiwk 

OBSA  DETA ILWK 

G0102V00    -   ON  004736  '  " 

GOIOIVOO  -  ON  002988 
GOIOOVOO  -  ON  0005  17 
G0099V00  -  ON  004214 
G0098V00  .  ON  004305 
G0097V00  -  ON  006245 
COMMAND? 
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Explanation; 

The  absense  of  a  dataset  name  on  the  SHOW  DIR  command  tells  WYLBUR  to 
build  the  name  using  the  standard  defaults.  The  dsname  constructed 
by  WYLBUR  was    therefore:      WYL  .  OZ . USR  .  L  I  B 

WYLBUR  I  ists  the  dataset  name  fol lowed  by  al I  the  members  in  the 
library. 

A  copy   of    the   member    COMPILE    is  brought    into    the   ACTIVE  file. 

After   a  global    change,    the  ACTIVE  file    is  saved    in   the  user's  library 

as  a  new  member  called  C0MP1L2,  COMPILE  is  then  scratched  from  the 
user's  library. 

The  dollar   sign    ($)      identifies  a  non-WYLBUR  dataset    in   the  SHOW  DSN 

command.  The  'ALL'  parameter  tel Is  WYLBUR  to  I ist  the  dataset 
characteristics. 

then  requests  System  Catalog  information  for  all  non-WYLBUR 
beginning   with    the   OBSA .  index. 


The  user 
da  t  ase  t  s 
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Word  P r o c e 5 s i n g  -  Do c 
-DOCUMENT  FORMATTING 


umen  t 


Formatt  ing 


WYLBUR  is 

an 

excel 

formatt ing 

app 

Meat 

secretar la 

1      p  e 

r  sonn 

proposals, 

c  0  n  t 

r  ac  t  s 

and  update 

of  u 

se  r  d 

documents  . 

eh  i 

c  1  e 

1  t 

c  a 

ge 

n  e  r  a 

0  r 

by 

at  1 

on  , 

ent      vehicle   for      word     processing   and  document 

be     effectively  used     either  by 
correspondence,        form  letters, 
etc.      or    by   publications  personnel    for  creation 
technical    manuals   and   other  large 

WYLBUR  offers  text  editing  capabilities  utilizing  medium  to  large 
scale  general  purpose  IBM  computers  Utilization  of  these  large 
mainframe  computers  provides  advantages  not  available  in  special 
purpose     minicomputer      Word     Processing       systems.  Some     of  these 

ad  van  t  ages    i nc  I  ude  : 


S  t  0  r  ag 

e  c 

ap 

ac 

1  ty  - 

I 

f 

you   are  cone 

e  r  n  e  d   w  i 

th 

editing 
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t 

e  X  t 

books,  rate 
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0  r 

manuals. 

WYLBUR 

an 

d 

y 

our  CO 

mp 

u  t  e 

r     can  handle 

fast  s 

t  0 
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age  and 

r  e  t  r  i  e 

V  a  1 

f 

0  r 
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e 

t  yp 

e  s     of  files. 

The 

po 

w 

e  r     0  f  a 

1  arge 

sc 

a  1 

e 

c  0 mp u  t 

e  r 
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t  an  t  whe 

n 

s  c  an  n i n  g 

1  arge 
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e  s 

0 

r    mak  i 
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gi 
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Cost  S 

a  V  1 

s 

-      1  f 

yo 

u  h 

ave  WYLBUR, 
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d 

n 

0  t  worry 
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e 
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r 

r  e 
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hardware 
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,  0 

f 

C  0 
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th 

e  t 
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0 

a 
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F  1  e  X  1  b 

i  1  1 

ty 

-  By 
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ng  WYLBUR's 

power  f 

u  1 

Execute 

Pr  og  r  a 
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ng 

c 
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Although  WYLBUR  has  capabilities  for  both  document  formatting  and 
word  processing,  these  two  applications  are  considered  separately 
because    they   are   accomplished   using   different  facilit 


e  s 


Wor_d  Piocessj^n^ 

Definition:  Capability   for      creation,        easy     correction   and  high 

quality  printout  of  smaller  documents  (letters,  proposals,  white 
papers,  contracts,  etc.)  'These  tasks  are  normally  accomplished  by 
secretarial  personnel  who  have  received  training  in  necessary 
techniques  The   reader      is   referred      to    the     OBS  WYLBUR  Reference 

Manual    for    a  detailed   description   of    the   commands   mentioned  below. 

A£D_r^oac  h 

Documents  are  created  from  source  by  typing  (using  the  WYLBUR  COLLECT 
Command)  into  the  WYLBUR  Active  file  and  creating  a  compressed  OS 
dataset    or   Library   member    (SAVE   Command)      containing    the    text.  Each 
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line  in  the  file  is  numbered  automatically  by  WYLBUR  and  subsequent 
editing  commands  may  refer  either  to  line  number  or  text  content. 
The  document  is  then  avai  I ab  I  e  for  immediate  access  (USE  command)  and 
correction  (UPDATE  command)  using  Full  Screen  Edit  on  3 2 7 0  -  c o mp a t  i b I e 
terminals  After  original  creation,  documents  are  printed  at  a  high 
quality  printing  terminal  (LIST  command)  for  review  by  author. 
Corrections  require  re-typing  only  of  the  items  in  error  and  the 
document   can  easily  be   re-listed  after  corrections. 

Ha  r_d_waj^£ 

Minimum  requirement  would  be  one  3 2 7 0  - c o mp a t  i b I e  terminal  (with 
upper /lower  case  feature)  for  creation/editing  and  one  high  quality 
output    terminal    (EG         DIABLO    1520)      for   printing.  Ideally,  each 

secretary  would  have  a  3270  terminal  and  one  output  terminal  for  each 
three     3270      terminals.  Although     some      installations     may  prefer 

exclusive  use  of  start-stop  terminals.  Full  Screen  Edit  is  available 
only  on   3270  compatible  devices. 

Func  t  I ons 

Capabilities  inherent  in  WYLBUR  for  Word  Processing  are  all  on-line 
functions    including    the  following: 

Textcreation-COLLECTcommand 

Editing  -  Full  Screen  Editing  via  UPDATE  command  or  EDIT  and  MODIFY 
commands   for    start-stop  terminals 

Global    Changes    -CHANGE   command  ,-. 

Paragraph  or   Line    Insertion    -    INSERT  and  COLLECT  command 

Paragraph   or    Line   Deletion    -   DELETE  command 

Justification  of  Paragraphs  -  JUSTIFY  command  provides  left  and  right 
hand    justification   of    paragraphs.  Any    line   width   may   be  specified, 

with     or      without     paragraph      indentation.  Most      often     used  to 

re-justify  paragraphs  after  corrections  have  been  applied  to  text. 
The     ALlGt^j     command  provides   ragged   right  justification. 

Centering-CEfiTERcommand 

Pagination  -  The  MARKER  option  of  the  LIST  command  provides 
pagination  capabilities  When  LISTing  at  the  output  terminal,  the 
terminal  will  pause  whenever  the  MARKER  is  encountered  in  column  1  to 
allow   a   fresh   page    to   be    fed  in. 

Moving  Blocks  of  Text  -  MOVE  command  moves  lines  or  paragraphs  to 
different    I  oca  t  i ons 

Duplicating   Text   From  Other    Documents    -   COPY   command  with   FROM  option 


-27- 


INTRODUCTION  TO  OBS  WYLBUR 

Word   Processing-Document  Formatting 


Example   of   Word  Processing  with  WYLBUR 

COMMAND^   col  I ec  t 

1  ,        ^   Ge  t  t  I ng   To   Know  WYLBUR  s 

2.  ^ 

3.  '    If    you   are   using  WYLBUR   for    the    first  time 

4.  ?    I t   w il I    be  helpful    for    you   to   first    read   the  User  Guide. 

5.  Basic  Editing  Commands  you  will    want    to  know  about  are: 
6  ^ 

7.  7  CHANGE  COLLECT  COPY  DELETE    INSERT  MOVE 

8.  ' 

9  If    you   have   access    to   3270    terminals,    you   will    want  to 

10.  learn   the  Full    Screen  Editing  Commands  including: 

n  .  7 

12.       ^  REVIEW  PF  PB  UNPROTECT  UPDATE  WL  WR  WC 
13  .  ^ 

14.  After   you  have   read  about    these  commands,    LOGON   to  a 

15.  terminal    and   experiment   with    their  use. 

16 .  ^    (ATTN)  *** 
COMMAND^   set    I  ength  60 
COMMAND^   center  1 

COMMAND^   align  3/5  9/10    14/15    indent   0  4  even 
COMMAND^   align  7    I  en  8  even 

COMMAND^    justify    12    I  en  40    indent   25  0  even 
COMMAND^  list 

1 .  Getting   to  Know  WYLBUR 

2. 

3.  If   you   are  using  WYLBUR   for    the   first    time    it   will  be 

4.  helpful    for    you   to   first   read   the  User   Guide.      Basic  Editing 

5.  Commands  you  wi  I  I    want    to  know  about  are; 
.  6  . 

■  7  .  CHANGE 
7  .001     COLLECT  '  ,..  ^. 

7  .002     COPY  ,     ,.-  , 

7.003  DELETE 

7  004     INSERT  .       _      '  .  ,     -  , 

7  .  005  MOVE 

8  ■ 

9  If    you  have  access   to  3270   terminals,    you  will    want  to 


0 


learn    the   Full    Screen  Editing  Commands  including 


12  REVIEW     PF  PB 

12.001  UNPROTECT 

12  002  UPDATE  WL  WR  WC 
1  3 

1  After    you   have   read   about    these   commands,    LOGON   to  a 

15  terminal    and   experiment   with    their  use 

COMMAND'  cha    •          '    1    t o    '  '    in    1  2 /  1  2   0 0 2 

12  REVIEW     PF  PB 

12  001  ■   ■  UNPROTECT 

002  UPDATE   WL   WR  WC 

COMMAND >  16  % 

COMMAND >  list 
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1  _  Get  t  I ng   To   Know  WYLBUR 

2. 

3  if    you   are   using   WYLBUR   for    the    first    time    it   will  be 

4  helpTuI  for  you  to  first  read  the  User  Guide.  Basic  Editing 
5_           Commands   you  wi I  i    want    to  know  about  are; 

6. 

7  .  CHANGE 

7.001     COLLECT  .  ' 

7  .  002  COPY 

7.003  DELETE 

7.004  INSERT 

7.005  MOVE  .  . 
8. 

9.  If   you  have  access   to  3270   terminals,    you  will    want  to 

10.  learn   the  Full    Screen  Editing  Commands  including: 

1  1  . 

12 .  REV lEW     PF  PB 

12  .001  ■  UNPROTECT 

12.002  '      UPDATE  WL  WR  WC 

13. 

14.  After   you  have   read  about    these  commands,    LOGON   to  a 

15.  terminal    and   experiment    with    their  use. 

16.  % 

COMMAND^    list   off   marker  % 

JOB  0865  OZUSR544  SUBMITTED  _ 

COMMAND^ 

Explanation 

In  COLLECT  mode,  the  operator  enters  text  without  concern  for  line 
length   or    word  placement. 

The  value  of  LENGTH  is  then  set  to  60,  Subsequent  formatting 
commands  will  thereafter  assume  that  60  is  the  desired  line  length 
unless   a  different    length    is  requested. 

The   title    line    isCENTE RED 

Three  different  groups  of  lines  are  then  ALIGNED  so  that  no  line  will 
exceed  60  characters,  yet  each  line  will  contain  as  many  characters 
as  possible  The  INDENT  parameter  tells  WYLBUR  to  indent  each  line  0 
characters  except  for  the  first  line  of  each  paragraph  which  is  to  be 
indented  4  spaces.  New  paragraphs  are  assumed  fol  lowing  each  blank 
Nne  EVEN  tells  WYLBUR  that  the  user  wants  to  change  existing 
indentat ion 

The  command  words  are  then  AL1G^JED  based  on  a  length  of  8  to  cause 
each   command    to   print    on   a   separate  line. 

The  FSE  comma r;ds  are  JUSTIFIED  so  that  left  and  right  margins  are 
exactly  even  (if  possible)  yet  no  line  is  to  exceed  40  characters  in 
I  eng  t  h 

The    file    is    then   LlSTed    for  review 
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Documen_t_  f.2.Lni§-LI.lD.3. 

Definition  Capability   for      creation,        easy     correction   and  high 

quality  printout  of  large  documents  such  as  user  or  technical 
manuals  These  tasks  are  normally  accomplished  by  personnel  with 
some  technical  ability  to  utilize  document  formatting  commands  which 
are  imbedded  in  the  text  and  processed  by  a  document  formatter  which 
is    invoked   either    on-line   or    via  batch  submission. 

A22_£oa£h 

Documents  are  created  in  the  same  manner  as  described  for  the  Word 
Processing      function  In      this   case     however.      Document  Formatting 

Control  Words  are  imbedded  in  the  text  file.  These  Control  Words  are 
processed  by    the   Formatter    and    the   result    is   a   finished  document 

Two  different  Formatters  are  recommended  for  use  with  WYLBUR.  The 
first  IS  PAGER,  which  is  supplied  by  OBS  and  included  with  a  WYLBUR 
license.  PAGER  is  a  series  of  EXECUTE  Programs  which  process  Control 
Words  in  a  text  file  which  is  contained  in  the  WYLBUR  Active  File. 
PAGER  provides   formatting   capabilities  including: 

•  Automatic   Pagination   and   Page  Numbering 
•Control    of    Page   Headings   and  Footings  .. 

•  Generation   of    a   Table   of   Contents   or  Index 

The  second  recommended  formatter  is  University  of  Waterloo  SCRIPT 
available  for  a  nominal  licensing  fee  and  supported  by  UOW  SCRIPT 
provides  capabilities  for  any  function  that  could  reasonably  be 
expected  from  a  document  formatter.  It  operates  as  a  batch  program 
but  works  hand-in-glove  with  WYLBUR.  WYLBUR  is  used  as  the  text 
editing  vehicle  for  creation  of  original  text,  insertion  of  SCRIPT 
Control  Words,  correction  of  errors  in  text  and  errors  in  SCRIPT 
Control  Words,  submission  of  SCRIPT  formatting  runs  to  batch,  and 
review   of    formatted   output    at    the    terminal    prior    to  printing. 

The  functions  of  UOW  SCRIPT  are  far  too  numerous  to  list  here  but  are 
generally  sufficient  to  meet  any  document  formatting  need  Functions 
availableinclude: 

•  Pagination  '.  .,  ' 

•  Table   of    Contents  and/or    Index  Creation 

•  Automatic  Justification 
•Footnotes 

•  Page   Headings   and  Footings 

•  Hyphenation  Dictionary 
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•  Subscripts   and  Superscripts 

•  Under  score 

•  Mac  r  o  Language 


1 1 
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In 
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Mowing  example, 

a     document  is 

shown 

prior  to 

being 

formatted  by  PAGER.  PAGER  Commands  are  interspersed  in  the  text.  A 
S  or  #  in  column  one  identifies  a  PAGER  Command.  The  following  PAGER 
Commands   are  used    in    the  example; 

SHEADROUT  Specifies  the  name  of  the  Execute  Program  which 
will  be  cal led  by  PAGER  after  each  page  is 
processed.  The     Heading     Routine     controls  page 

numbering,      index     or    table   of      contents  generation 
and  page  headings  or  footings. 


SPAGESIZ 

Tells     PAGER  th 

e     maximum  number 

of  1 

1  n  e  s 

to 

be 

printed   on  each 

page.      This  value 

r  e ma  1 

n  s  in 

ef 

feet 

for    the  entire 

document  unless 

0  V  e  r  r  i 

d  d  e  n 

by 

the 

SNEWPAGE  statem 

en  t  . 

SLENGTH 
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Causes  a  warning  message  to  be  issued  if  a  text 
line    IS  modified   to  exceed   the  specified  LENGTH. 
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Causes  a  Table  of  Contents  entry  to  be  genera -ted 
without    forcing   a  page  break. 


A  standard  Heading  Routine  is  provided  with  PAGER,  This  routine  will 
number  pages,  print  title,  section  and  topic  headers,  and  build  a 
Tab  I e   of    Contents . 

The    following    is   an   example   of      an    Input    Text   File,      containing  PAGER 
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Control  Stat  emen  t  s : 
COMMAND^  list 


0  001  SHEADROUT  WYL  OZ . USR , E XEC #UHE AD  ON  WYLlOl 

0.002  SPAGESIZ  15 

0.003  SLENGTH  80 

0.004  STITLE  OBS  UTILITIES  MANUAL 

0.005  SSECT  BATCH  UTILITIES  CREV    I. CP' 
2. 

3.  OBUPDTE    IS  a  driver   program   that    invokes   the    IBM  utility 

4.  program,  lEBUPDTE. 
5  . 

6.  OBUPDTE  al lows  concurrently   running    jobs   to  share   the  same 

7.  existing   output    data   sets   by    insuring    that  exclusive 

8.  control    is  given  during  each  updating  process. 
9  . 

10.  OBUPDTE  should  always  be  used    instead  of    lEBUPDTE,    for  all 

11.  processing  functions. 
12. 

13.  All    functions  are    identically  controlled  by  lEBUPDTE 

14.  utilitycontrolstatements. 
16.  #TCON  EXAMPLE 

17  .  JCL  EXAMPLE  ; 

18.  ■  . 

19.  //STEPl         EXEC  PGM=OBUPDTE  . 

20.  //SYSPRINT  DD  SYSOUT^A 

21.  //SYSUTl       DD       DISP  =  SHR,DSN  =  XXX  PROCL  IB 

22.  //SYSUT2       DD       D 1 SP  =  SHR , DSN  =  XXX . PROCL  1 B 

23.  //SYSIN         DD  DATA 

24.  ./     ADD     NAME  =  NEWPROC , L  IST^ALL 

25.  ./     NUMBER     NEW  1 ^ 1 000 ,  I NCR= I  000 

26.  //NEWPROC     EXEC  PGM=PGMNAME 

27.  //   DD   

28.  //   DD   

/* 


COMMAND'   execute    from  pager    on   catig  clear 

TC   OFFSET    IS  100 

DONE 

COMMAND'    list  offlineunnuppercc 

The  following  sample  represents  the  output  that  was  produced  afte 
the  Table  of  Contents  has  been  moved  to  front  of  the  document 
Actual    page   ejects   are   represented   by    four    blank    lines    in    the  sample 
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EXECUTE  PROGRAMMING 


One  of  the  most  versatile  facilities  of  WYLBUR  is  its  Interactive 
Programming     Language      (EXECUTE)  EXECUTE     programming     provides  a 

high-level  interactive  programming  language  that  is  available  to 
every  user  High-level  means  that  it  is  simple  to  use,  interactive 
means  that  you  control  what  it  does  --  you  can  have  it  converse  with 
you  at  the  terminal,  prompt  for  information,  and  display  results 
on-line  There   are     several    sophisticated     general    arithmetic  and 

logical  functions  available  that  you  can  use  in  an  EXECUTE  program  to 
make  it  as  powerful  and  effective  as  any  other  high-level  programming 
I  anguage 

An  EXECUTE  program  is  a  col  lection  of  WYLBUR  commands  executed  in  a 
control  led  sequence,  EXECUTE  programs  may  be  executed  from  the 
ACTIVE     file     or      from     a  disk      dataset.  There     are     commands  for 

branching,  B r an c h - An d - L i nk  ,  and  transferring  control  to  another 
EXECUTE  program  You  may  use  string,  decimal,  or  integer  variables 
as   well      as  man>'     other    WYLBUR   special      keyword   variables.  You  can 

instruct  WYlBUR  to  prompt  the  terminal  user  for  information  and  give 
your  program  the  information  that  is  typed  in  You  can  have  WYLBUR 
substitute  values  at  certain  points  in  your  program  or  evaluate  an 
e>-oression  and  then  substitute,  the  value  of  the  expression.  There 
are  also  dec ' s  i  on  -  mak  i ng  commands.  Once  you  have  composed  your 
EXECUTE  Prog-am  m  your  ACTIVE  file,  you  tell  WYLBUR  to  execute  it. 
WYlBUR  takes  the  program  from  the  ACTIVE  file  and  puts  it  into  your 
secondc'-y   work    area     called   the   EXECUTE   File  EXECUTE   programs  are 

interpretive  in  nature.  WYLBUR  processes  each  command,  resolving 
expressions   and   making     substitutions,      if    specified  If      there  are 

errors  in  the  program,  WYLBUR  interrupts  the  command  that  failed  so 
you   can   correct    it      on    the   spot    and   resume   execution  When   you  are 

satisfied  with  the  program  and  want  to  keep  it  for  future  use,  you 
can   save    it    on  disk. 

There  are  many  applications  for  EXECUTE  programs.  Any  time  you  need 
input  from  a  user  in  order  to  set  up  documents  or  run  jobs,  you  can 
use  an  EXECUTE  program  to  automate  the  process.  Building  customer 
lists'"  Writing  letters'*  Performing  operating  system  maintenance?* 
Transiatirig  programs  from  one  operating  system  to  another?  Let  an 
EXECUTE    program   do    the    work    for  you, 

Wha_t_  ai^e  j_he   EXECUTE   P^o C2r_amm_i_ng^  l30.3.M3^e  commands'* 

There  are  some  special  WYLBUR  commands  that  you  can  use  as  program 
instructions  in  an  EXECUTE  Program,  Additionally,  you  can  use  any  of 
t^-ie  other  text  entry  and  editing,  document  processing  or  remote  job 
processing  commands  already  described  in  the  preceding  sections  The 
special    EXECUTE -or  I  ented   commands  are: 

•    EXECUTE  To      initiate     an   EXECUTE     Program,        or  perform 
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branching   within  it 


.  SET  VALUE 

.  READ 

.  IF 

.  RESTORE 


to  assign  a  value  to  any  of  the  stri'ng,  decimal, 
integer    or    keyword^  variables. 

to  get  input  from  the  user  at  the  terminal  or 
f  r om   the  ACT  1  VE   f  I  I e . 

t  o  mak  eadecision. 

to  bring  an  EXECUTE  Program  out  of  the  EXECUTE 
File  into  the  ACTIVE  file  for  correction  when 
debugging. 


To  use  the  features  of  the  WYLBUR  Preprocessor  which  performs 
expression  resolution  and  value  substitution,  you  will  want  to  use 
special    global    parameters  by   telling  WYLBUR   to  SET   or  SHOW: 


ESCAPE 


SK  iP 


RESCAN 


.  EXECUTE 


RETURN 


the  character  that  triggers  text  substitution  in 
an    i  ns  t  r  uc  t I  on  . 

the  character  that  causes  substitution  to  be 
bypassed  on  certain  words. 

a  count  of  how  many  times  to  process  an  EXECUTE 
program  when  nested  levels  of  substitution  are 
required,- 

a  'trace'  facility  that  determines  if  EXECUTE 
instructions  will  be  logged  to  the  terminal  as 
they  are  executed. 

the    'branch-and-link'    line  number. 


Briefly,  the  general  arithmetic  and  logical  functions  available  to 
you    through    the  EXECUTE   programming    language  are: 

String    (character)  Functions: 


SUBSTR 
INDEX  . 
VER  1  FY 

F  IND 


produce   a  substring   of    a  string. 

find   the   starting   column   of    a  particular  string. 

examines  two  strings  to  determine  whether  or  not 
the    first    string    is   contained    in    the  second 

examines  two  strings  to  determine  the  position 
of  the  first  character  in  the  first  string  that 
IS    found    in    the   second  string. 


"^'^^  deternine    the    length   of    a  string 

Encode/Decode  Functions 
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•  DIS^LA"^  converts     a'"guments        to      internal  hexadecima 

representation. 

•  SHEX  convertshexadecima.  I  toEBCDIC. 

•  NHEX                   converts  hexadecimal    to  integer. 

•  WHEX                   converts  hexadecimal    to  decimal . 
ConversionFunctions: 

•  NCONVERT           converts  string   or    decimal    to  integer. 

•  WCONVERl            converts  string   or    integer    to  decimal. 

•  SCONVERT           converts  integer   or   decimal    to  string. 
Expression  Evaluation: 

•  Add 

Subtract 
Multiply 
/  Divide 

()         Parenthesis   to  alter   order   of  evaluation 
11  Concatentation 

Relational  Operators: 

EQ  equal 

NE  notequal  . 

LT  less  than 

LE  lessthanorequal  -  .. 

GT  greaterthan 

GE  greater    than   or   equal  .  . 
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EXECUTE  Program  Example 


1.  SET  EXEC  NOLOG  TERSE  ■   ^  Jf 

2.  SET  ESCAPE  &  ■       •  ■ 

3.  READ  STRING  SI    PROMPT    'STARTING  MBR^ 
4  .  IF    (SI   EO   •  ■  )   EXEC  3 

5.  READ  STRING  S2  PROMPT    'ENDING  MBR^  ' 

6 .  IF    (S2  EG   ■  ■  )   EXEC  5 

7.  SET  VALUE  W0=59000 

8.  COLLECT  DIR  FOR  $SYS 1 . PROCL 1 B  FRO  &S1    THRU  &S2  ON  CAT 

9 .  DEL  F 

10.  NUM  5900 1  .  —  .  .  / 

11  SET  VALUE  WO  =  WO+  1 

1 2  SET  VALUE  WULAST  .  . 

13 .  READ  STRING  S5  USING  &W0 

14.  COPY  F/L  FROM  SSYS 1 , PROCL I B#&S5  PLUS  0  ON  CAT 

1 5 .  COMMENT       MEMBER  &S5 

1 5  MOD   '   EXEC    '    AND  ^    '  *  '  3 

17.  SAV  SSYSl .PROCL IB#&S5  LINES  F/58999  ON  CAT  REP 

18  SET  VALUE  W0=W0+1 

19  IF    (WO  GT  Wl )   EXEC  22 

20 .  DEL  F/58999 

2 1 .  EXEC    13  " 

22 .  SET  ESCAPE 

23 .  COMM  END 
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Explanation: 

This  EXECUTE  program  will  search  each  member  of  °R0CLIB,  starting  and 
ending  with  member  names  or  member  name  patterns  specified  by  the 
user.  For  each  applicable  member,  the  Program  will  find  all  EXEC 
statements,  allow  the  user  to  modify  them  and  replace  the  updated 
member    i n   PROCL  IB. 

NOLOG  terse  is  specified  to  prevent  WYLBUR  from  logging  each  command 
asitisexecuted.- 

The  Escape  character  is  specified  which  tells  WYLBUR  tc  perform 
substitution   when    the   escape   character    is  encountered 

The  sta''ting  and  ending  Member  names  are  asked  for.  Note  that  if  no 
response    is   provided,    the   request    is  repeated. 

The  applicable  portion  of  the  directory  from  PROCLIB  is  stored  in  the 
ACTIVE    file,    beginning   at    line   number  59001 

Counters  a^e  initialized  and  the  first  member  name  is  read  into 
string   variaDle  5  (S5). 

The  actual  member  is  then  read  into  the  beginning  of  the  ACTIVE  file 
and  a  line  is  typed  at  the  terminal  informing  the  user  of  the 
appl'caiDlemerbername 

The  MODIFY  co  mmand  is  issued  so  that  each  JCL  EXEC  statement  that  is 
not  a  comment  may  be  modified  by  the  user.  The  updated  member  is 
tnen   r  ep I aceo    in   PROCL I B  -    .    ■    .  . 

!f  more  members  are  to  be  processed,  the  current  member  is  deleted 
from   The   ACTIVE    file   and   processing   continues   at    line  13. 

Notes  ■ 

Depending  on  the  complexit/  of  the  required  modifications,  it  may 
have  been  'easible  to  code  the  EXECUTE  program  so  that  it  actually 
made  tne  moaifications,  rather  than  having  the  user  be  responsible 
for      them  The     STRING     Processing     Functions       provide  powerful 

facilitiesforthistypeoftask. 

The  Branching  function  within  EXECUTE  programs  utilize  WYLBUR  line 
numbers.  An  EXECUTE  Program  Assembler  is  provided  with  WYLBUR  so 
labels  may   be    issued    in    lieu   of    actual    line  numbers 
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EXECUTE  Pio^^ams  D_i_s^£_^bu_^e d  w_^lh  WYLBUR 


A  number  of  EXECUTE  Programs  are  provided  with  'your  license  to 
WYLBUR.  Some  of  these  programs  w T! I  be  useful  to  your  installation 
on  a  daily  basis,  some  will  provide  excellent  examples  of  EXECUTE 
Programming   techniques   and     some   are    just   plain   fun.  Most    of  these 

nor  customization  by  the  installation 
names  and  disk  volume  serial  numbers. 
ASSEMBLER"  source  is  provided  for 
in  a  separate  library  which  also  is 
tape.      Provided  programs  include: 


programs  will      require   some  m 
for    such     things  as  data  set 
Documentation     and/or  "EXEC 
applicable     EXECUTE  Programs 
provided   on   your  distribution 


ASSEMBLE 


This  "EXEC  ASSEMBLER"  allows  the  use  of  labels 
when  writing  EXECUTE  Programs  in  lieu  of 
referring  to  actual  line  numbers  This  can  be 
especially  helpful  when  you  are  writing  a  fairly 
large  EXECUTE  Program  which  may  need  to  be 
renumbered  several  times  The  Assembler  also 
optimizes  your  EXECUTE  Programs  by  compressing 
unnecessary  characters  and  provides  a  symbolic 
notation   for    pre-defined  variables. 


HELP 

D  1  sp 
for 
und  1 

lays  syntax   and  detai  led  command  d 
requested     command.        ACTIVE  fil 
s  t  u  r  bed  . 

escr  ipt  ion 
e  remains 

L  IBALLO 

Bu  1  1 
PDS 

ds   JCL   and   submits  a  batch    job  to 
(Library)    for    the  user. 

allocate  a 

L IBEXP 

Bu  1  1 
size 

ds   JCL   and   submits  a  batch    job  to 
of   a  PDS  . 

expand  the 

PAGER 

The 
Prog 

OBS     WYLBUR       Document  Formattin 
ram. 

g  EXECUTE 

RANDOM 

A   r  a 
0  t  h  e 

ndomizing     routine   which     may  be 
r   EXECUTE  Programs 

invoked  by 

SORT 

P  r  0  V 
numb 

ides     the   square     root     of     a  user 
e  r  . 

supp  1  1  ed 

SHOWVT 

D  1  sp 
(  for 
cus  t 

lays   disk    volume   usage     by    the   WYLBUR  system 
System  Programmers     use      -   requires  minor 
omizing   by    the  installation). 

TRKCAP 

D  1  sp 
spec 

lays       track     utilization  based 
ified  LRECL,    Key    length   and  Block 

on  user 

size. 

GAMES 


A  number  of  popular  games  are  provided  for  your 
enjoyment 
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THE   OPERATIONS  SUPPORT  SYSTEM 


I  NTRODUCT I  ON 


The  OBS  Operations  Support   System    (OSS)      was  developed  by   OBS  because 

we  felt  there  must  be  a  better  way  to  run  a  data  center.  The  major 
goals  of    the   system  were. 

•  To  develop  uniform,  easy  to  update,  reliable,  and  complete 
documentation   for   all    production    jobs   run  at  OBS. 

•  To  provide  as  much  information  about  the  jobs  as  necessary  to 
allow  operations  personnel  to  make  informed  decisions  when 
prioritization  of   work   becomes  critical. 

•  To  develop  audit  trails  to  facilitate  research  if  an  output  item 
IS  not    received     by    the  customer 

•  To  automate,  to  whatever  extent  possible,  the  job  scheduling, 
submission  and  restart  process  to  minimize  card  handling  errors 
and  errors  normal ly  caused  by  erroneous  assumptions  that  can  often 
be   made   by   operating  personnel. 


Since  WYLBUR  was  already  being  used  for  program  development  at  OBS, 
and  it  provided  most  of  the  facilities  that  seemed  necessary,  it  was 
chosen  as  the  vehicle  for  implementation  of  OSS.  OSS  takes  advantage 
of   WYLBUR ■ S  capab  i  I  i t  i es   f or  : 

On-line    interaction  with  a  user    (Execute  Programs) 

Global    search   and  retrieval 

Jobsubmission 

General    text    creation   and  manipulation 
Pj_J_e   De  sc  r_j_g^  t_j_on 


Date  (Calendar)  File  -  A  WYLBUR  file  which  contains  one  entry  (line) 
for  each  day  on  the  calendar  for  the  next  18  months.  Each  date  is 
given  scheduling  attributes,  E  G.,  010278  is  a  Monday,  first  Monday 
of    the   montn,    a  weekday,    Julian   date   78002,  etc 

Scheduling  Requirements  File  -  A  WYLBUR  file  which  contains  two  types 
°^    entries  The    first    type      is   a      "Batch"    entry   which      indicates  a 

group  of  jobs  which  are  logically  associated  and  normally  run  in  a 
pre-defined      sequence  The    second      type      is     a   "Job"      entry  which 
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The 


Op  e  r  a  t  ions 


Suppor  t  System 


describes   a   single      job         Both   types   of      entries   contain  information 
describing     the      types   of      days     when      the      job     or    batcii     should  be 
scheduled   to   run,  le., 
month,  etc. 

Job  Profile  Library  -  A  I 
members   of    two   different  t 

Batch  Expansion     f^i embers  - 
jobnames  associated  with 
name   for    this   type   of  memb 

Job  Profile  Members  -  Eac 
to    lobname)    contains    the  f 


p  k  d 

firct  MnnHxavy 
• '1  MUMUay 

/-if      t  h  Q 

0  T    I  n  e 

"WYLBUR"    1 ibrary 

which  contai 

n s  many 

es  . 

Th  1 

s   type     of  member 

contains  a 

list  of 

"Ba 

tch"    as  described 

above.  The 

member 

1  s 

equal    to   the  "Ba 

tch"  name. 

J  ob 

profile   member  ( 

member      name  i 

s  equal 

1  ow 

1 ng   gr  oups   of    i  n  f 

0  r  ma  t  ion  . 

Operator 

Re 

c 

ap  I 

n 

f  0 

r 

m 

a 

t  1  on 

I 

nf 

0 

r  ma  t  1 

on 

c 

one 

e  r  n 

1  ng 

J  ob 

execution 

r 

e 

qu  1  r 

e 

m  e 

n 

t 

s 

which 

W  0 

u  1 

d 

be 

i 

mp 

or  t 

an  t 

to 

the 

computer 

ope 

r 

a  t  0  r 

F 

0 

r 

e  X  amp  1 e 

n  0 

r 

ma  1  r 

UP 

t 

1  me 

,  0 

ther 

j  ob 

dependenc 

i  e  s 

max 

1 

mu 

m 

t 

ape  d  r  1  V 

e  s 

n  u  mb  e 

r 

of 

sc 

rat 

ch  t 

apes 

needed,  i 

n  p  u 

t 

t  ap 

e 

f 

1 

1 

e 

s ,    c  0  mme 

n  t 

s  , 

etc. 

Prod 

u 

C  t  1  0 

n 

Con 

t  r 

0 

1 

Information    -  I 

n 

for 

ma 

t 

i 

0 

n  1 

mp  0 

r  t 

an 

t  to 

prop 

e 

r  JO 

b 

out 

pu 

t 

h an d 1  i n g  . 

For  e 

X 

amp 

1  e 

numb 

e  r 

an 

d 

type 

0  f  p 

r 

1  n  t  e 

d 

ou  t 

pu 

t 

s 

de  c  0  1  1  a  t  i 

ng  a 

n 

d  b 

u  r 

s 

t 

1 

n  g  1 

n  f  0 

r  m 

at 

ion, 

any 

0 

u  t  pu 

t 

t  ap 

e  s 

non  -  standard 

c  omp 

1 

e  t  1 

on 

c 

0 

d  e  s  , 

P  1 

ck 

u 

p  or 

d  1  s  t 

r 

1  bu  t 

1  0 

n  1 

nf 

0 

r 

ma t  i  on ,  job 

sens  i 

t 

i  V  1 

ty 

i 

n 

form 

at  1 

on 

etc. 

Rest 

a 

r  t  /R 

e  r 

un 

I 

n 

f 

0  r  ma  t  i  0  n 

Sp ec  i 

a 

1 

1  n 

s 

t 

r 

u  C  t  1 

on  s 

to 

be 

foil 

0 

wed 

1  n 

c  a 

s  e 

t 

he    job  must 

be  re 

r 

un 

0  r 

r 

e 

star 

ted 

Job 

S 

u  b  m  1 

ss 

1  0  n 

1 

n 

f 

0  r  ma  t 1 0 n 

Th  1  s 

c 

on  s 

i  s 

t 

s 

of 

the 

P 

r  0 

due  - 

t  1  on 

JCL 

r  e 

qu  1 

r  e 

d 

to   run   the  j 

ob  . 
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F u n £_tj_o n  a J_  De  s£_i^j_£__t__i_o n 


Function  - 

To 

s  c  h  e  d 

u  1  e 

and     submit    the     production    jobs  for 

a  given 

day 

Refer 

t  n 

F  1  n  1 1  r 
r  1  y  u  1 

e  1 

for    srhpiTir^tir    renresentat  ion 

1  . 

S  c  h  e  d  u  1  e 

r  1 

1  1 

r~\  \i  r\\r  q 

1  1  V 

tha    FXFrilTF    Prnnr^^m      whirh    ben  ins  the 

n  r  n  r  p  c,  c. 

and  p  r  0  V 

1  H  P 
1  U  C 

<;      t  h 

;^|pnH3r    d,^tp    which       is    to    be  scheduled 

The 

EXECUTE 

Pr 

0  g  r  a  m 

f  1 

nds     the   proper      entry    in      the  Calendar 

File, 

stores  t 

he 

"  a  t  t  r 

1  b  u 

tes"    for    that   date,    and   continues  proce 

ss  1  ng 

I  . 

1  h  e  bene 

du  1 

Ren 

iiirpTient^    File       is    searchpd      for  pvprv 

job  or 

"batch" 

w  h  1 

c  h    1  s 

t  0 

run   on   any   day   and   has     an  "attribute 

equal 

to  those 

o  _> 

s  0  c  1  a 

ted 

with    the   given   date.          We   now  have  a 

list  of 

batches 

and 

jobs 

wh 

ich   are    to   be   run   on   the   scheduled  date 

The 

process 

may 

b  e  1 

n  t  e 

rrupted   at    this   stage    to   add   or  delete 

batches 

or  jobs 

w  h  1 

c h  ha 

\i  e 

cr)pf-|3|    rpnupsts    nendinn    for    today's  wo 

r  k 

J  . 

r  0  r      e  a  c 

h  B 

a  t  c  h  , 

the   Batch     Expansion     Member    is  found 

by  the 

EXECUTE 

Pro 

gram. 

At    the  end  of    this  process,    we  have  a  j 

ob  list 

which  CO 

n  t  a 

1  n  s 

a  s 

ingle     entry   for      each    job      to   be  run 

on  the 

s  c  h  e  d  u  1  e 

d  d 

ate. 

A 

H  . 

1  n  e   s  c  n  e 

du  1 

e  r  ma 

V  a 

gain   wish    to   manipulate    the    job    list  to 

insert 

J  0  D    n  d  rr;  e 

of  On 

-Re 

quest      jobs   or      One-Time    jobs     and  dele 

t  e  any 

ct  r\  t  r  IOC 

f  0 

r       1  0 

bs 

which     are   not      to     run     because  of 

special 

1   c  <^  U  c  b  1.  b 

The 

j  0  b 

submission  process   may   be  suspended 

at  this 

point  to 

e  n 

sure 

t  ha 

t   all    special      requests  have  been  recei 

V e d  and 

acted  up 

0  n 

When  job 

s 

u  b  m  1  s 

S  1  0 

n    IS   desired,        the   scheduler  invokes 

the  job 

sub     1  S  S  : 

c  n 

E  X  E  C  U 

TE 

Program     which    then   reads    the      job  list 

For 

a  ^  1  1      B  1  '  1. 

r  y 

1  n  t 

he 

job    list,        the   Job   Profile  Library  me 

mb  e  r  is 

I  0  u  n  c  an 

d  t 

he  Jo 

b  S 

ubmission    Information    (JCL)      is  capture 

d  .  In 

this  man 

n  e  r 

one 

b  1 

g   file   of    run-time   JCL    is   built.  Once 

this  IS 

d  C  C  0  m  0  1  I 

she 

d  the 

s  c 

heduler      may   wish   to    insert      special  ov 

err  ides 

w  1  1  1  V,  1  1  rr  1  cj 

/  h 

a  V  e  b 

e  e  n 

requested    for    certain    jobs   for    this   run  only. 

6 

With  one 

C  0 

m  m  a  n  d 

the   production     workload    is   submitted  i 

n  t  0  the 

input    q  u 

e  u  e 

s  a  w  a 

1  t  1 

ng   release   by    the  operator. 

7 

A   high  p 

r  1  0 

r  1  t  y 

ba 

tch    job    IS   submitted   to     produce  Recap 

r  epo  r  t  s 

for  the 

ope 

r  a  t  0  r 

an 

d   production   control    (PC).      The  report 

program 

reads    t  h 

e  J 

ob    1  1 

s  t 

created    in   Step   4         For    each   entry  in 

the  job 

list,    t  hi 

e  J 

ob  Pr 

of  1 

le   Library   member    is   found   and   the  appr 

op  r  1  a  t  e 

Operator 

an 

d  PC 

Rec 

ap    information    is   extracted   and  formatt 

e  d  into 

two  rep 

or  t 

s 

Th 

e   system     catalog      is     read     at    this  t 

1  me  to 

d  e  t  e  r  m  1  n 

e  V 

0  1  u  m  e 

s 

erial    numbers   for    input      data   sets  and 

a  tape 
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OPERATOR 
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8.     At    this  point,    the   foliowing  work   has  been  accomplished: 

•  All  production  jobs  hav/e  been  submitted  into  the  proper  job  class 
and  await   release  by   the  operant  or. 

•  The  operator  has  a  report  which  contains  all  execution 
requirements  for  1£  £IllZ  jobs  which  are  to  run 
tonight . 


A  tape 

pu 

1  1  1 

i 

s  t  has 

been  c 

r  e  a  t  e  d 

s 

0  th 

a  t 

the 

major  i  t  y 

of 

input 

tapes 

can 

be 

p  u  1  led 

and  in 

the  CO 

mp 

u  t  e  r 

r 

0 

0  m 

P 

r  1 0 r    to  e 

X  e  c 

u  t  1  on 

of  the 

JO 

bs  . 

The   p r 

odu 

C  t  1  0 

n 

c on  t  r  0 

1      d  ep  a 

r  t  men  t 

h 

as  a 

r 

e 

p  0  r 

t 

de  sc  r  i  b  i 

which 

output 

w 

1  1  1 

be  prod 

uc  ed  t 

on  i  gh  t 

ho 

w 

1  t 

i 
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ha 
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(bur  st 

ed  , 

dec 

0 
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boxed , 

1  abe  1 

ed 

,  et 

c  . 

) 

1 

t  s 

d 1 s  t  r  1  bu 

t  1  0 

n  and 

t  i  m  i  n  g 

r  e 

qu  1  r 

e 

men  t  s , 

an    1 n  d  1 

cat  ion 

0 

f  wh 

1  c 

h 

bs 

have  the 

h  i 

ghe  s  t 

p  r  i  0  r  i 

ty 

i  n 

case 

some 

work 

mu 

St 

r 

e 

ma  1 

n 

i  n c omp  1  e 

t  e 

and 

d  0  c  u  me 

n  t  a 
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for  ac 

c  ep  t  ab  1 
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1  t 

1  on 

CO 

d 

e  s 
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or  each 

j  ob 

step 
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a  1  1 

ows 

P 

e  r  Sonne 

1    to  ch 

e  c  k    f  0 

r 

sue  c 

e  s 

s 

f  u  i 

c 

0 mp 1 e  t  i  0 n 

of 

each 

job. 


9 

The 

op 

e  r 

ator   and  production  c 

on  t  r 

0  1  p 

e 

r  s 

on 

ne  1 

now 

anno 

tate  their 

r  e  p  o 

r  t  s 

as 

wo 

r  k    is   comp 1 e  t  ed .  Th 

1  s  e 

f  f  ec 

t 

1  V 

e  1 

y  P 

r  0  V  i 

d  e  s 
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appr 

oach 

to 
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nsure     that   each  job 

i  s  c 

omp  1 

e 

te 

d 
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u  r  a  t 

e  1  y 

and    in  its 

en  t  1 

r  e  t  y 
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I  f 

th 

e  r 

e    IS     a  system     cr  ash 

0  r 

J  ob 

fa 

1  1 

u  r  e 

du 

r  1  ng 
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ng  , 

affected    jobs  must  be 

r  e  r 

un 
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r  e 
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r  ted 

I 
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mp  1  1 
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i  so r 
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de 

S  1 

gne 

e  w  i 

1  1  u 

s 

e  WYLBUR's 

f  ac  1 

li  t  1 

e  s 

t  0 

clean     up   any   du  r  a  t  i 

0  n  -  0 
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b 

d 

1  s 
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a  t  as 

e  t  s 
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n  e  c  e 
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y 
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su 
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e  r 

V  1 

so  r 
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e  n  1 

n 

vokes  the 

Re  r  u 

n/Re 
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r  t 

Execute  File  and  is 
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d  t 
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1  n 
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J  ob 
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the 
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t  e    job         The  Execute 
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J 

0  b  Profile 

L  1  br 
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1 
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r 

ma 

t  1 
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J 
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s   displayed   for    the  super 

V  1  so 

r 
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r  e  a 
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The 

run   JCL  is 

then 
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n 

the   active   file  for 

the 
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r 
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so 

r 
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nse  r 

t 
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n  e  c  e 

ssa 
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and   resubmit  the 

job. 

A 

n 

en 

try 

1  s 

au 

t 
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1 

n 
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ewed  each 
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e 
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wh 
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2  Formatted  documentation      is  available     to     both  operations  and 

production   control    personnel  .  Neither    group   needs   to     contend  with 

documentation     pertinent   only      to   the     other    group.  Each   group  is 

presented  with  a  fresh  copy  ea£h  day  of  the  documentation  applicable 
to   those    jobs  which  are   to  be   run   that  day. 
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PERFORMANCE  CONSIDERATIONS 


WYLBUR    is   the  most   economical    system  of    its  kind  because: 

•  All  program  code  is  written  in  assembler  language  using 
efficientcodingtechniques. 

•  WYLBUR  IS  a  product  born  of  thorough  design  and  careful 
implementation  by  a  small  group  of  talented  technical 
people 

•  Nearly  all  I/O  routines  are  coded  using  EXCP,  the  most 
efficient  access  method  available.  The  only  exception  to 
this  standard  is  when  an  instal  lation  chooses  the  VTAM 
implementation   of  WYLBUR. 

•  Only  one  copy  of  code  exists  for  al I  WYLBUR  users,  not  one 
copy   per    user    as  with   many  systems. 

WYLBUR  has  always  had  a  reputation  for  low  overhead  and  although  OBS 
has  added  major  features  to  WYLBUR,  we  have  not  neglected 
performance  Performance  is  especially  critical  to  good  response 
time  and  also  important  when  the  host  environment  is  in  the  370/135 
to  K8  range  You  will  find  no  competitive  system  with  features 
comparable  to  WYLBUR  which  requires  less  CPU  time  resources  We  are 
proud  that  each  new  release  of  WYLBUR  has  resulted  in  lower  resource 
consumption 

The  following  chart  will  give  you  an  idea  of  what  to  expect  in  terms 
of    resource  consumption. 


CPU 


370/ 1 58 


370/145 


Normal    Load  of 
Concurrent  Users 


30 


15 


Da  1  I  y  CPU  Minute 

Requirement  for 

Entire   WYLBUR  System  50 


70 


8-22 


Average  CPU  seconds 
Per    Connect  Hour 


7-20 


8 


The  above  consumption  statistics  are  averages  based  on  the  actual 
experience  of  current  installations  The  following  statistics  were 
taren  from  one  months  experience  on  the  OBS  370/158  Mod  1.  At  the 
time  these  statistics  were  measured,  the  OBS  WYLBUR  System  supported 
a  pea^.  of  42  concurrent  users  with  an  average  of  about  30  concurrent 
users  Wv^BUR     users     on      the      OBS      computer      tend      to     be  fairly 


-47  - 


INTRODUCTION   TO  OBS  WYLBUR 


Performance  Considerations 


sophisticated  WYLBUR-  users  and  make  extensive  use  of  EXECUTE 
programs. 

T  o  t  a  I    C  o  n  n  e  c  t 

HoursProvided;  6161, 
TotalNumber 

of   Sessions  13,434  '.■ 

Chargeable  CPU  '11.11   CPU  Seconds 

Time  per   Connect  Hour 

Total    (Jobstep)  16.58  CPU  Seconds 

CPU   Time  per   Connect  Hour 

Total    Daily  CPU  65.5  CPU  Minutes 

TimeUsed(workdays) 

Total   CPU  Time  1703  CPU  Minutes 

Usedforthe  Month 


-48- 


INTRODUCTION   TO  OBS  WYLBUR 


Se c  u  r  i  t  y 


SECURITY 


The  principal  function  of  the  Access  Manager  feature  is  to  administer 
the  access  via  WYLBUR  to  information  belonging  to  various  users.  The 
following  paragraphs  define  in  £e n e£a_[  terms  the  applicable  concepts 
of    ownership     and    the   manner    in     which   access    is   controlled.  It  is 

important  to  note  that  the  implementation  of  access  control  may  vary 
from  this  general  description,  since  many  of  these  access  controls 
may  be  selectively    implemented  by   the    installation  manager. 

You  may  also  want  to  review  the  sections  "IMPLEMENTATION"  and 
"CUSTOMIZING"    which     occur    later    in     this  document.  These  sections 

provide  more  information  about  WYLBUR  system  variables  and  highlight 
the  I n s t a  I  I  a t  I  on  -  dep enden t  features  such  as  ownership,  naming 
conventions,    user    exits,  etc. 

0wne£sh_j_2. 

In  general,  a  WYLBUR  user  is  the  owner  of  a  file  or  dataset  he 
creates  during  a  WYLBUR  session,  or  a  batch  job  he  submits  during  a 
session  In  both  cases,  ownership  is  reflectedin  the  name  which 
WYLBUR  assigns  to  the  dataset  or  job,  since  that  name  will  include 
(in   a   form  selected   by    the    installation)    the   USERID  of    the  owner. 

Installations  who  desire  ownership  based  on  criteria  other  than 
USERID  may  alter  this  convention.  Loc a  I  I y  -  des i gned  ownership 
determination  code  may  be  placed  in  the  appropriate  user  exits 
described    in    the   section  "Customizing". 

Most  installations  observe  a  convention  which  additionally  permits 
certain  datasets  to  be  collectively  "owned"  by  multiple  WYLBUR  users 
who   constitute   a     "group"  Such   collectively-owned   datasets     may  be 

created  by  any  user  within  the  group.  Again,  the  name  of  the  dataset 
reflects  its  ownership,  but  in  this  special  case,  the  USERID  of  a 
user  within  the  group  cannot  be  utilized  to  form  the  name  (since  that 
would  make  the  dataset  belong  to  a  single  user).  To  deal  with  this 
special  case,  collect  ively-owned  datasets  are  named  as  though  created 
by  a  user  within  a  group  who  has  the  special  "initials"  PUB  as  part 
of   his  USER  I  D 

By  way  of  example,  assume  an  installation  selects  the  standard  WYLBUR 
USERID  and  dataset  naming  conventions  where  the  five  character  USERID 
IS  composed  of  a  two  character  group  code  ' GG '  and  t h r e e  -  c h a r ac t e r 
initials  portion  'IN'.  In  this  case,  the  dataset  created  as  a  result 
of    the  command 

SAVE  MYFILE 

GG    1  I  I  , MYF  1  LE       Ad  ataset    to  be   collectively  owned 
the   group    '  GG  '    would   be   created     by   either    of  the 


woo  Id  be  named  WYL 
by  any  user  within 
f  0  I  lowing 
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SAVE  &PUB . OURF  ILE 

SAVE  WYL .GG .PUB .OURF  ILE  ' 

and   the   resulting  dataset   would  be  'named  WYL. GG, PUB  OURFILE. 

In  general,  the  owner  of  a  dataset  or  batch  job  may  perform  any 
legitimate  WYLBUR  function  which  may  operate  on  the  dataset  or  job. 
For  jobs,  this  includes  the  capability  to  FETCH,  PRINT,  PURGE  or 
CANCEL  any  particular  job  For  datasets  this  includes  the  capability 
to  create,    replace,    modify  or    scratch  any  particular  dataset. 

^2.IllL°l  9.1.  ^£.9.111  I2L  ^2.^1 

The   following    job   management    functions   are   subject    to   access  control: 
CANCEL 

FETCH  •  . 

HOLD 

PR  I  NT 

PURGE 

RELEASE 

ROUTE  _  ■ 

The  owner  of  a  job  may  perform  any  of  these  operations.  A  user  who  is 
not  the  owner  of  a  job  may  perform  any  of  these  operations  upon  that 
job  if  he  can  supply  the  keyword  of  the  owner,  or  if  the  user  is 
identified  as  being  authorized    in   the  Access  Control    Table  (ACT). 

A  user  with  SYSTEMS  Privilege  may  perform  any  of  these  operations  on 
ANY  job  unless  that  user  is  logged  on  to  a  dial-up  (Switched) 
terminal. 

^°IllL°l  £l  ^££il^  l£l  2^1.^££ll  '  ' 

The  following  functions  pertaining  to  datasets  are  subject  to  access 
control: 

CATALOG 
CONDENSE 
COPY  FROM 
EXECUTE  FROM 
RECATALOG 
SAVE 

SCRATCH  ... 

SHOW  DIRECTORY  - 

SHOW  DSNAMES 

SHOW  SPACE   ON  <volume> 

SHOW  VOLUMES 

UNCATALOG 

USE  ■ 
Access   control    to   datasets    is   most   basically   restricted   at    the  volume 
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level .  A  user  may  not  access  in  any  way,  datasets  residing  on  disk 
volumes   other    than    those   available   within   his  session. 

The  available  volumes  are  determined  by  both  the  "public"  volumes 
specified  in  the  job-step  JCL  for  the  WYLBUR  system  and  the  interplay 
of  an  Access  Control  Table  (ACT)  with  any  "control  led-access"  volumes 
specified  in  the  job-step  JCL-  The  only  method  by  which  a  user  may 
alter  the  set  of  volumes  available  during  his  session  is  to  assume 
the  identity  of  another  WYLBUR  user  via  the  SET  GROUP  and  SET  USER 
KEYWORD  commands  (described  in  Reference  Manual).  By  utilizing  these 
commands,  and  correctly  supplying  the  keyword  for  the  set  USERID, 
volumes  defined  for  the  set  userid  become  available.  Since  a 
privileged  user  may  always  supply  a  correct  response  to  the  KEYWORD? 
prompt,  he  may  acquire  access  to  those  volumes  defined  for  any  other 
user. 


No  user,  whether  privileged  or  not,  may  perform  any  potentially 
"destructive"  operation  upon  a  dataset  residing  on  a  disk  volume 
which  has   the   READ  ONLY    (abbreviated  RO)  attribute. 


Any  dataset-related  function  may  potentially  be  performed  for 
datasets  which  reside  on  a  disk  volume  which  has  the  attribute  USE 
AND  SAVE  (abbreviated  U/S),  A  user  who  is  not  the  owner  of  a  dataset 
may  perform  any  of  these  operations  upon  a  dataset  if  he  can  supply 
the  keyword  of  the  owner,  or  if  the  user  is  identified  as  being 
authorized  in  the  ACT.  Any  user  may  perform  any  of  these  operations 
upon  a  dataset  which  is  collectively  owned  by  another  group  if  he  can 
identify  a  user  within  the  owner-group  and  supply  that  user's 
keyword 

INDIVIDUAL  USERS  OR  GROUPS  OF  USERS  MAY  BE  ALLOWED  OR  DENIED  ACCESS 
TO  SPECiPiC  DATASETS,  GROUPS  OF  DATASETS  (BASED  ON  INDEX  NAME 
QUALIFIERS)  OR  ENTIRE  VOLUMES  BY  CODING  THE  APPROPRIATE  MACROS  IN  THE 
ACT 


Imp.lf.H^n.llI].'^   Access   ^3^3Q^e_r_  Funct__i_o^n 

Most  Access  Manage""  function  is  buMt-in  and  always  in  effect,  as  a 
result    of      the   WYLBUR     system  generation.  The   following     are  under 

control    of    the  installation: 

-  definition   of    "public"    dasd  volumes 

-  definition   of    " c o n t r o  I  I  e d  -  a c c e s s  '  volumes 

-  creation   of    an   Access  Control    Table  (ACT) 

The  presence  of  a  usable  ACT  at  WYLBUR  system  initialization  time 
coupled  wiih  the  presence  of  one  or  more  control  led-access  volumes 
activates  the  Access  Manager  function  for  user  volume  control  If  the 
Access  Manager  function  is  not  enabled  (AM  is  OFF)  then  only  public 
volumes   are   available    to   any   user  If    the   Access  Manager    is  enabled 

Crj),      then     public    volumes     and   designated     control  led-access 
volumes   are   available      to   users  In   addition,      the   SET     and  SHOW  AM 

commands   can   be  used    to   examine   and   modify    the   AM  state. 
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The  implementation  of  the  Access  Manager  provides  several  additional 
benefits:  , 

•  disk   space     allowance  accounting  can     be   assigned     to  selected 
DASD   vo I umes ; 

•  multiple   concurrent      disk    I/O  operations     can   be     permitted  to 
the   same   disk    volume    (non-VSl    systems  only); 

•  reduced  overhead   for   access   to  owned  datasets; 

•  ability   to     utilize  special    EXECUTE     Programs   to     monitor  disk 
volume  access  utilization  data, 


•    ability   to   control      on   which   disk    volume     WYLBUR   recovery  will 
SAVE  a  user   ACT  I VE  file. 

J_n_t_e  r_f_ac  e_  t_o  Se_£ijr__i_t__y  Pa£k_a2es 


Installations  desiring     a  WYLBUR 
ACF2  and     RACE  may  use   the  Secur 
section.      Access   may   be  verified 
in   these  exit  routines. 


interface  to  packages  such  as 
ity  Exits  described  in  a  later 
through   service   requests  issued 
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ACCOUNT  iNG  FAC  IL IT lES 


WYLBUR  produces  a  session  accounting  record  for  each  terminal 
session  These     records   contain     statistics     concerning  resources 

consumed  during  the  session  and  generally  conform  to  a  TSO 
logon/logoff      record  The      installation   may     choose      to  have  these 

records  written  to  the  system  SMF  files  or  to  a  user  defined  dataset, 
or      both  Information     contained      in      the   record      includes  session 

elapsed  time,  TP  and  DASD  1/O's,  CPU  time  charged  and  user 
identification  information.  A  sample  DSECT  of  the  Accounting  Record 
follows: 


MILTEN  ACCOUNTING  ROUTINE  RECORD 

« 


* 

RECORD  WRITTEN  AT 

LOGOFF  TIME  FOR  M I LTEN/WYLBUR 

♦ 

SESSl 

ON ^  NOTE 

NO 

RECORD   IS  WRITTEN  UNLESS 

« 
* 

LOGOFF  OCCURS 

IN 

BEHALF  OF  USER. 

• 
♦ 

COPY 

GLOBALS 

AND 

CODE  SYSDEFN  MACRO  TO  SET  GLOBAL 

SYMBOLS 

p  A  r  p 

1 

1 

ARREC 

DS 

OF 

SPACE 

1 

ARLEN 

DS 

H 

INCLUSIVE  LENGTH 

ARRDWBB 

DS 

H 

X'OOOO' 

ARS 1 ND 

DS 

XL  1 

SYSTEM    INDICATOR  X ' 02 ' 

ARTYPE 

DS 

XL  1 

RECORD  TYPE  CODE    (SMF  OR  OTHER) 

ART  1  ME 

DS 

BL4 

LOGOFF   T 1  ME  OF   DAY  (.01 

SECONDS 

ARDATE 

DS 

PL4 

LOGOFF  DATE    ( 00YYDDD+  ) 

ARSER 

DS 

CL2 

SYSTEM  SERIAL  FROM  CVT 

ARMDL 

DS 

CL2 

SYSTEM  MODEL  FROM  CVT 

SPACE 

1 

DS 

XL2 

RESERVED 

ARTEL 

DS 

F 

SESS 1  ON  FLAP  T  I  ME  (.01 

SEC)  BIN 

ARTP 1 0 

DS 

F 

TERMINAL    I/O  COUNT 

ARU  1  D 

DS 

CL8 

USER  ID 

ARUG 

EOU 

ARU  1  D , & 

iGL 

USER  GROUP 

ARU  I 

EQU 

ARU  I  D* ( 

&  IGL 

)  ,  &  11  L             USER    I  N  1  T  I  ALS 

ARACNO 

DS 

CL  1  2 

■    ACCOUNT  NUMBER  F  I  ELD 

ARAN 

EQU 

ARACNO , 

&  1  AL 

USER  ACCOUNT  NUMBER 

A  R  I E  R  f1|  D 

DS 

CL4 

TERMINAL    ID  ENTERED  AT 

LOGON 

ARCCMPr.'M 

DS 

CL8 

MILTEN   TERMINAL  COMPONENT  NAME 

ARUCB 1 D 

DS 

CL3 

UNIT   CONTROL   BLOCK  ID 

DS 

XL  1 

RESERVED 

ARPPEL 

EOU 

*  -  ARREC 

PREFIX  LENGTH 

SPACE 

1 

USER 

WYLBUR  U 

SAGE 

DATA 

ARUSEP 1 

DS 

OF 

FULLWORD  ALL  1 GNMENT 

DS 

F 

RESERVED 
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ARWYLT 1 M 

DS 

F 

CPU  ED' 

ITING  TIME    (   01  SEC) 

ARWYLPGW 

DS 

H 

NUMBER 

OF 

PAGE  WRITES 

ARWYLPGR 

DS 

H 

NUMBER 

OF 

PAGE  READS 

ARWYL JOB 

DS 

H 

NUMBER 

OF 

JOBS  SUBMITTED 

ARWYLLST 

DS 

H 

NUMBER 

OF 

L  1ST  OFFL INES  SUBMITTED 

ARWYLCND 

DS 

H 

NUMBER 

OF 

CONDENSES  SUBMITTED 

ARWYLOPN 

DS 

H 

NUMBER 

OF 

OPENS 

ARWYLCAT 

DS 

H 

NUMBER 

OF 

CATALOG  ACCESSES 

ARWYLDAW 

DS 

H 

NUMBER 

OF 
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I MPLEMENTAT 1  ON 


Although  WYLBUR  provides  a  wide  range  of  powerful  capabilities  and 
must  interface  directly  with  the  Operating  System,  it  is  simple  to 
install.  No  modification  to  the  Operating  System  is  required  or 
desirable    for    implementation   of  WYLBUR. 

OBS  WYLBUR  supports  parameterized  initialization  time  configuration. 
The  initialization  of  the  WYLBUR  system  is  controlled  by  several 
initialization  macros,  namely  the  INITOI  and  the  DEFNSYS  macros. 
Values  may  be  specified  for  dsname  prefix  pattern,  userid  pattern, 
jobname  pattern,  number  and  group  of  page  datasets,  number  of  page 
buHers,  maximum  number  of  concurrent  users,  job  management  and  so 
on  These  macros  effectively  allow  the  installation  to  design  the 
WYLBUR   system  according    to    individual    needs   and  specifications. 

The   benefits   of   parameterized    initialization  include: 

•  WYLBUR  systems  which  are  identical  at  the  load-module  level 
except    for    those   parts   with   JES  or    SCR  dependencies. 

•  Distribution   of   preventive  maintenance. 

•  Users  can  make  adjustments,  including  those  for  performance 
tuning  without  special  knowledge  of  WYLBUR  internals  and  without 
the   presence   of    source  code 

Increased  responsiveness  on  the  part  of  OBS  in  diagnosing  any 
problems   encountered    in   the   use   of  WYLBUR. 

JCL  for  the  following  jobs  is  provided  with  the  installation  tape  and 
should   be   used    to   accomplish    the    installation   of    OBS  WYLBUR. 


1.  JCBCl    Allocate   and   catalog    the    target   datasets  prior  to 

unloading    the   primary   distribution  tape. 

2.  JOB02   U  nioad      the   primary     distribution      tape    into  the 

dat  ase  t  s  a  I  I ocat  ed  . 

3.  JOB03  Link-edit    the     WYLBUR  utility     programs    into  the 

WYLBUR    I oad    I  i br  ar  y  . 

4  JO&04   Assemble   and    link    the   HASP/JES  interface. 

5  JOB05  Link-edit    all    the   WYLBUR  programs    into   the  WYLBUR 

Load  Library 

6  JOB05  Allocate   and    initialize    the   run    time  datasets 


-55  - 


INTRODUCTION   TO  OBS  WYLBUR 


Implementation  Requirements 


7.  JOB07  Create   WYLBUR  procs. 

8.  JOB08  Assemble       and        link-edit         the  parameterized 

initialization  moduTe. 

9.  JOB09    Initiate  M I L TEN/WYLBUR  system 
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DOCUMENTATXON 


WYLBUR    IS     well    documented  and     Licensees   are  provided     with  complete 

sets   of      manuals   when      the  system      is   del  ivered           New  commands  and 

features  are  documented  in  manual  updates,  wnen  released. 
Documentat  ion    inc  ludes  . 

Oli  ^Ik^UR  Biliience  Summary 

A  pocket-sized  reference  to  all  Commands  and  options  Special  terms 
are  defined  and  a  place  is  provided  for  each  user  to  record  his  or 
her    personal  ized   commands    (DEFjNEs)  . 

OBS  WYLBUR  Use£  Guj_de 

An  introduction  to  WYLBUR,  this  document  is  readable  and  provides 
sample   sessions  plus   other    helpful    hints   on   using  WYLBUR 

OBS  WYLBUR  Reference  Manual 


A  detailed  description  of  each  WYLBUR  Command  and  parameter.  This 
manual  is  quite  thorough  and  should  be  available  near  each  terminal. 
The  first  three  chapters  provide  introductory  material  and  a  good 
general  description  of  WYLBUR's  3270  support  and  Window  Mode  Full 
Screen  Edit 

^Ik§U^  and  O^e^a^^o n s  Gu^d e 

Intended  for  use  by  the  WYLBUR  coordinator  at  each  installation,  this 
manual  contains  details  on  system  architecture,  system  installation, 
privileged  commands,  Account  and  Network  definition  datasets,  the 
Access  Manager,  NOTIFY  capability.  System  Utilities,  and  System 
messages  and  codes. 

03S  WYLBUR  Use^  Ex^^  Guj_de 

The  User  Exit  Guide  is  a  thorough  discussion  of  the  various  user  exit 
routines  supplied  by  WYLBUR  that  allow  each  installation  to 
effectively    tailor    their  system 

PAGER  Use£  Gu_^de  • 

A  thorough  discussion  and  examples  of  how  to  use  PAGER,  the  document 
formatting   EXEC   provided   with   your  license. 

The  Reference  Manual,  User  Guide,  User  Exit  Guide  and  Reference 
Summar /  are  also  distributed  in  machine  readable  format  on  the 
distribution  tape  Once  installed,  you  may  print  additional  copies 
as  necessary  Documentation  is  also  provided  by  OBS  if  you  wish  to 
order    preprinted  quantities 
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5umma£_y 

In  summary,  the  WYLBUR  Users  Group  provides  a  vehicle  for  interaction 
among  users  and  an  open  communication  line  to  the  vendor  This 
enables  installations  to  be  involved  in  the  future  directions  of 
their  software  investment  and  to  benefit  from  the  ideas  of  other, 
similarinst alia t ions. 
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TRAINING  USERS 


Ensuring  that  users  know  how  to  effectively  use  WYLBUR  is  an 
important  facto:"  in  productivity  improvement.  Formal  training  is 
available     to  WYLBUR     Licensees  Normally     of    two     days  duration, 

classes  provide  an  explanation  of  all  important  commands  and 
facilities  Terminal  sessions  are  used  to  allow  the  student  to  apply 
techniques  learned  in  class.  Training  materials  include  a  notebook 
for  each  student.  An  overhead  projector,  blackboard,  and  terminals 
are   required   for    the   course   and  exercises. 

As  a  supplement  to  our  training  program  OBS  offers  a  video  tape 
tutorial  The   tapes     have  been     graduated    into     six   thirty  minute 

sessions  and  provide  a  comprehensive  overview  of  major  functions. 
The  video  session  is  accompanied  by  a  training  manual  and  practice 
terminalsessions. 

After  training,  users  will  begin  using  WYLBUR  and  benefiting  from  it 
rapidly  The  OBS  WYLBUR  User  Guide  is  recommended  to  familiarize  new 
employees  with  WYLBUR,  The  Reference  Summary  is  also  a  handy  pocket 
reference    to   all    of   WYLBUR's  commands. 

Special  training  sessions,  tailored  to  a  specific  type  of  user  (Word 
Processing  users  or  Management  Seminar,  for  example),  can  usually  be 
arranged   to   meet   any  unique  requirements. 
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n d  Supp o 


MAINTENANCE   AND  SUPPORT 


One  of  the  major  benefits  of  software  packages  is  support.  No  one  is 
more  important  to  OBS  than  our  customers.  We  strive  to  make  sure 
that  each  customer  is  happy  with  WYLBUR  and  using  it  to  capacity. 
Therefore,  if  you  have  a  problem  with  WYLBUR,  call  us.  If  you  have 
discovered  a  bug,  we'll  fix  it.  Superzap  RTFs  will  be  used  in  an 
emergency,  followed  up  by  load  or  source  module  replacement.  When 
our  users  call  with  a  problem  it  is  our  goal  to  provide  either  a  fix 
or  temporary  bypass  before  the  conversation  is  over.  Fortunately 
WYLBUR    is   very   stable  and  not   subject    to   frequent  problems. 


Maintenance  also  includes  new  releases  of  WYLBUR  and  Documentation 
updates.  It  has  been  our  policy  to  provide  new  releases  of  WYLBUR 
(even  those  containing  major  enhancements  such  as  Window  Mode  FSE  ) 
without   additional    charge    to   our  customers. 


Additionally,  the  development  of  parameterized  initialization  time 
configuration  plays  a  major  role  in  the  stability  and  responsiveness 
OBS  provides   to  any  problem   that   might   affect   you  as  a  user. 
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Custom iz  ing 


CUSTOM  1 Z ! NG 


Sour  ce  code 


is     provided     at     no     additional      charge     to  perpetual 
licensees,      OBS  does   not    encourage   source   code   modifications,  however 

''ation   customizing     and   have   developed   a  series 
to  support      this.       An      installation  can  now 
WYLBUR     to     meet      their      unique  requirements 
sour  ce  code  . 


we  do  encourage  instal 
of  user  exit  routines 
effectively  customize 
without   disturbing  the 


The  user   exit   routines  supplied  with  WYLBUR  are 


SCNEX 
SOFEX 
KWRREAD 
KWRWR  1  TE 
ACCTNOVL 
ACCTWR 1 T 


7.  WUCMDX 

8,  WUXDSNO 


WUXDSN02 
WUX JC30  1 


1  .  WUXJOB02 
2.  WUXSUBOI 


The 

The 

The 

The 

The 

The 

wr  i  t 

The 

The 

ex  I  t 

The 

The 

exit 

The 

The 


sign-on   exit  routine, 
sign-off   exit  routine. 
Keyword  Record   read  routine. 
Keyword   Record   write  routine. 
Account   Number    validation  routine 
Session   Accounting  Record 
e   r  ou  t I n e  . 

user    command   exit  routine. 
DSNAME  construct  ion/mod i f  icat  ion 

DASD  Security   exit  routine. 
JOBNAME   construct  lon/modi  f  icat  ion 

JES  Security  exit  routine. 
Job   Submit   exit  routine. 


Each  installation  is  provided  with  complete  documentation  when  coding 
the  exit  routines,  and  the  WYLBUR  support  team  is  available  to  answer 
questions   or    provide   additional  information. 
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SUMMARY 


WYLBUR  is  the  best  selection  among  the  many  productivity  products 
offered    in    today's   market.      The   major    reasons  are: 

.  Multiplicity  of  uses  -  No  other  system  can  offer  such  complete 
facilities    in   so  many  areas. 

On-line     program  development      means    increased  productivity 
from   your  programmers. 

The   Operations     Support   System     means  better  organization, 
documentation   and   ability    to   respond   for    your    data  center, 

WYLBUR's  Word  Processing  capabilities  offer  improved 
productivity,  better  accuracy  and  faster  turn-around  from 
your    administrative   and-  secretarial  personnel. 

Document    formatting   via  either   PAGER     or   SCRIPT  provides  an 
excellent    vehicle    to   automate   your    large   documents.  . 

Even  DP  Management  can  benefit  from  WYLBUR  by  using  it  to 
store  ano  edit  summary  material,  proposals,  white  papers, 
etc. 

•  Because  WYLBUR  is  so  widely  accepted  by  its  users,  it  will  help 
attract  and  keep  the  best  programming  talent.  Good  workers  always 
enjoy  working  with  the  best  tools  Users  at  new  WYLBUR  installations 
invar  laoly  report  satisfaction  that  management  has  recognized  one  of 
their    problems   and   has    implemented   an   excellent  solution. 

Because  WYLBUR  is  widely  used  in  Universities,  you  will  find  many 
young   programmers   already   familiar    with  it. 

•  Low  Operating  Cost  -  OBS  WYLBUR  offers  its  features  at  lower  cost 
in       CPU     time        than     any       competitive       system     offering  similar 

capabilities 

This  means  you  can  provide  WYLBUR's  services  to  more  users  and  thus 
increase  productivity   over    a  wider    base   of  people. 

Low  CPU  overhead  is  also  critical  to  good  response  time  and  good 
response    time    is   extremely   critical    to   user  acceptance 

•  Stabilit/  -  No  system  is  worth  having  if  it  is  subject  to  frequent 
outages  o r  ma i n t e n an c e  problems  The  fact  that  OBS  WYLBUR  is  offered 
by  man/  of  the  largest  service  companies  in  the  US  and  Canada 
attests    to    its   viability   and    its   reputation    for  stability 

.    Price    -      We're   sure   you'll    agree    that    WYLBUR      is   reasonably  priced. 
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Low  marketing 
software  dollar 
Keeping   your  so 
well. 


costs     and     attention  to 
goes   for      software,  not 
ftware   budget    in    line  will 


expenses     means     that  your 
heavy  marketing  expenses, 
surely  please  management  as 
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OPTIflUii  SYGTEliS 
I  liCORPORATCD  .- 

5UPERl;YLBUR 


IliTROOUCTIOfJ   (foil  2) 


Til  i  s  mo  rii  i  ii:ss '  talk  is  orr>anizcd  into  the  follov/in-^  areas: 
Intornctivc  Text  Editing/  v/liicli  includes  tlie  basic  cor.nand  language  of 
Supe  i'\/y  1  Lu  r ;  Rcnote  Job  Entry  and  Retrieval,  v^fiic'i  includes  tiie 
facilities  in  Supe  r-v/y  1  bu  r  for  subraltting  job  to  the  batcfi  system  and 
tfie  subsequent  retrieval  of  the  job  output  for  reviei/  at  the  terminal; 
Document  preparation,  \;hiicf"i  concerns  tiie  facilities  v/fiich  provide  a 
viable  v/ay  to  prepare  documents  in  Supe r\.y  1  bu r ;  Tlie  Macro  Facility, 
vviiicii  is  a  cofiiplcte  p  ro^  ramr.i  i  ng  laru;uase  in  V.'ylbur;  and  ttie  systems 
considerations,  \;hich  concern  the  devices  and  operating  systems  v/ith 
which  Supe rv.'y  1  bu r  can  be  used. 


INTERACTIVE  TEXT  EDITIRG   (foil  5) 
(foi  1  ii) 

Tlie  basic  premise  for  the  creation  of  Super\;ylbur  is  that  the  text 
editors  available  on  the  market  are  not  very  easy  to  use.  SUPER\.'Ybr;UR 
was  designed  as  an  easy  to  use  editor  whose  command  language  resembles 
the  English  language.  Uur  experience  in  training  new  users  proves 
tiiat  such  a  goal  v;as  valid.  Experienced  users  find  that  tiie  natural 
syntax  of  th.c  command  language  does  not  distract  from  their  editing 
goa  Is. 

Input  can  be  in  all  upper  case  or  in  upper  and  ]ov;er  case.  Th.e  user 
can  specify  wliicli  mode  he  vnsfies  to  use  for  aqy  portion  of  a  terminal 
session.  l/itfi  the  upper  case  option,  all  text  is  converted 
internally,  and  entry  can  be  in  capitals  or  lower  case  at  the 
terminal.      in  upper  ai"id   loi.-er  case  i.tode,.  the  case  shifts  are  honored. 

Thi;     line    length  ^.llo\.cd    is   f  rci  i  C;   to   111-  cl'aracters.     Tlils  also  i.^eaiis 
\'e  can  edit  any  file   tliat  i'las  a   logical    recuru  size  up   to     Vj'j  byues.' 
Tills     allo\.s  editing  of  batcli   files  as   long  as   tiie   logical    record  size 
is   less    tiian   2!i5  atid  blksize  will    fit     I  ri     pa  rame  te  r- spec  I  f  i  ed  buffer 
size. 

l.'e  allov/  for  several  thousand  lines  in  a  \.'orl;Ing  file.  Tiie  working 
file  refers  to  the  copy  of  any  data  set  internally  in  liYLbUR.  Tiic 
Cojjaclty  of  a  working  file  actually  dc[)ends  on  tlie  density  of  th.e 
material.  If  you  iiavc  a  lot  of  blanks,  there  v;  i  1  1  be  more  lines  tlian 
if  there  Is  a  great  deal  of  material  on  ea.ch  line.  An  estimate  of  the 
capacity   is  around   IC,  Oi;0   lines    in  eacli  working  file. 

l.'e  also  allov;  i.iultiple  \.orkIng  files  called  t  ei.ipo  r  a  r  I  e  s  (abb  rev  I  a  t(2cl  t 
or  temp).  Any  cor.U:ianJ  to  wlii  ch  a  t  or  temp  and  tiie  name  of  the 
temporary  is  a,');.ie  nueci  0[k:  rates  on  that  ter.i()orary  data  set.  It  is  thus 
possii^le  to  have,  for  e;;amplc,  3  or  i;  pro:;rams  or  documents,  and  all 
the   cor.i  anJs   ca.n  v.ork  on  of  these. 


FACILITIES   FOR  ADCREGSIfiG  TEXT   (foil  b) 
Line  injf.ibcr  directed.      (foil  G) 

It  is  necessary  at  this  point  to  discuss  th.e  facilities  v/hich  exist  in 
SLPuKWY LliUf<  for  specifying  \.'hat  data  the  editor  is  to  operate  on.  If 
you  v;ou  1  d  consider  tiiat  the  follov/ins  i  tens  are  specified  as  the 
operand  of  a  list  command  (entered  as  list  or  1),  it  may  help  in  your 
understand  i  n^ . 

The  first  way  to  specify  the  data  on  v/hich  to  operate  is  by  the  line 
number  associated  v/ith  the  line  in  the  v/orl;in::  file.  It  should  be 
noted  that  line  nui.ibers  are  assigned  v.-hen  data  enters  the  system  and 
renumberin:^  is  done  only  \.'hen  requested  by  the  user.  There  is  an 
eii^ht  dicit  line  number,  that  is  five  digits  followed  by  three  decimal 
places. 

As  in  the  first  exai.iple,  the  lino  number  can  be  sin^^le,  in  a  ran^e,  or 
firs  tor  last. 

There  is  also  a  current  line  pointer.  CurretTt  (abbreviated  c)  is  an 
addressable  line.  For  example,  if  you  are  entering  text  and  you  see  a 
line  that  you  have  entered  v/hich  is  incorrect,  you  can  set  back  in 
coiiT.iand  mode  and  say  modify  c  v/hicii  stands  for  modify  the  current 
line.  Th.e  modify  comi^iand  v/ill  be  explained  later  in  the  talk.  The 
current  line  is  updated  by  collect,  modify,  copy,  move,  insert,  delete 
or  point,  all  of  v/hicii  v/ill  be  discussed  later  in  this  presentation. 
\le  can  set  up  a  ranr.e  of  lines,  i.e.  a  ser>i.ient  of  the  prosfai.i,  as  in 
tliO  first  of  tlie  t\.o  examples  ai.  uuiui^  bcundcu  by  tnc  current  line 
throu^;h  tiie   litie  nuiiibered  'rOO. 

Relative  addressing   is  also  allowed.  .- 

Relative  addressing  refers  to  tfie  syntax  illustrated  in  whlcli  \/e 
Si^ccivy  <.i.  cxisi;ii.,;  Si.crLiiio  ijoiiit,  plus  or  r.ilnus  a  relati\'c  1  i  ru- 
positiofi.  ror  exai,:ple,  tiie  i'irL>t  +j  lines  will  be  ulie  fourtn  line  in 
any  dr.ta  set  re.^ardless  of  v/iiat  the  liiie  numbers  of  that  data  set  are. 
It  is  not  tiie  first  line  plus  tliree  in  any  kind  of  line  number  sense. 
It  is  strictly  relational.  In  the  second  example,  (100-7/150  +  5),  tlio 
lines  that  \:c  v/oulu  operate  on  v/ill  be  seven  lines  before  line  100, 
v/hatever  that  line  nuiiiber  is  through  five  lines  after  line  15C, 
v/h.atever  line  tuii.iber  that  is.  I  might  mention  tliat  you  can  make  any 
combination  of   th.ese   terms    in   a  single  commafid. 


Content  directed   (foil  7) 


Tiie  ability  also  exists  to  look  at,  or  select,  tliin?;s  by  content  of 
the  line.  The  first  cxani:)le  is  to  look  for  any  line  whicfi  has  that 
particular  string  'HAPPY'  or  narro\,'ins  the  possible  candidates  as  in 
the  2nd  exar,iple  by  specify  iri^i  it  is  to  bei^in  in  a  column  7  or  in  the 
third  exar.iple  by  specifying;  the  stritis  is  contained  bet\/ecn  columns  10 
and  20.  And  finally,  by  a  combination  of  criteria  directin,^  the 
searcti  to  either  a  string's  beginninr^  in  column  7  or  contained  betv/een 
columns   15  and  30. 


(foil  a) 


Content  can  also  be  defined  in  terms  of  classes  of  thinr;s  \.'hlch  you 
can  list.  For  e;:ar,iple:  List  any  d  i  I  t  in  column  10.  Al  so^  it  is 
possible  to  concatenate  operands  as  in  list  'AB'  concatenated  v/ith  a 
di^it.  There  is  no  conca  ten  ta  t  i  on  symbol  in  tfie  syntax,  so  that 
concatenated  items  are  just  placed^one  after  tlie  other.  There  is  also 
a  class  v.'fiich  is  a  blank.  The  problem  there  is  if  you  want  to  change 
the  string;  'the'  in  a  document  usin^  many  editors,  you  can't  say 
change  'the'  to  'XXX'  because  not  only  tlie  "the's",  but  tlie  "tfiere's", 
etc.  v.'ould  be  changed.  Go  you  are  forced  to  say  change  '  the  '  to 
'XXX'.  That  changed  r.iost  of  \;iiat  you  v/anted,  unless  'tfie'  happened  to 
occur  at  the  beginning  or  the  end  of  tiie  line.  l/hat  you  can  now  put 
in  is  list  blank  concatenated  v/Itli  'tiie'  concatenated  vjlth  blank  and 
tiiat  means  th*e  string  that  I  set  up  nov;  can  find  eithicr  a  blank  or  the 
beginning  or  end  of  the  line  with   the  string  'THE'. 


(foil  9) 


The  pa  t  to  rn -o  r  i  Gil  tcci  operators  arc  \/ays  of  definlns  or  narrov/ing  the 
searCi'i  for  a  content  operator.     Let's   look  at  tfie  exar.iples; 

DIGIT  i:OT   (C  OR  9) 

That  \;ould  be  an  octal  dl^it. 
Or   i  n  the  second 

(DIGIT*2  or  UPPER-2)  DIGIT   '    '  DICIT*t| 

example     which  would  represent  a   telepfione  number  minus  the  area  code. 

Set  operators  use  union,  intersection,  complement.  Set  operators 
operate  on  multiple   lines.     An  example: 

•OPEN'    IC    Mil   '  lilPUT' 

l.'i  th  'intersection'  you  can  put  multiple  constraints  on  a  strln::^  by 
say  in;;  list  'A'  in  '3'  in  'C'  in  'L'.  As  loni^  as  I  keep  using  'in',  1 
can  continue  to  narro\;  the  search.  'In'  and  'intersection'  frequently 
give   the  sar.ie  result. 


(foi 1  10) 

l.'e  can  also  divide  tliin^^s  by   instance  of  occurrance.     An  example: 

5RD  AFTER   'ADC'    1  » 

the  tliird  lirie  after  eacli  line  containing  'ABC'  in  column  1.  Tlie 
second  examp 1 e  : 

EVERY  2tlD  AFTER  SOTii  of    '  $ ' 


every  second  line  (every  other)  line  after  the  fiftieth  line 
containing  a  $. 


(foil  11) 


As  I  r,ientioned  earlier,  tiicse  terr.is  can  be  conibined.  Please  observe 
tile  f  o  1  1  ov;  i  lu'.  exeu.ip  1  e s  . 

The  first  exci.iple  has  lines  bctv/een  the  nui.iber  200  and  500  in  v/hich 
tiie  v/ord   'balance'    is  contained  bctv/een  colui.ins  10  and  50. 

In  our  second  exai.iple,  tliose  lines  \;here  ABC  starts  in  column  7  or  h(: 
or  72   in   the  hth   line  throu^^fi  tl)e   line  numbered  25. 

Tiie  result  in  tlie  tfilrci  and  fourtli  examples,  in  botli  cases,  is  those 
lines  v^liicii  have  f:AbPH  be,::^  inning  in  column  10  arid  also  have  GEOFvCE 
besinning  in  column  21  1  y  i  n^  betv/cen  line  num/uer  200  and  the  next  to 
last  line   in   tiie  file. 

The  last  exar.iple,  all  one  comr.iand,  lists  tiie  first  line  after  tlie  line 
tiiat  lias  'T/i'  in  column  10  and  'FbAGA'  in  column  IC  and  'FLAGAOii' 
soniei.iiG re  else  on  the  line  in  every  line  follov/Ing  that  line  wh.ere 
'symbol '  occurs    in  column  1 . 


SUPEru;YLDUR  COf.i.ACLC.      (foil  12) 


We  now  lool;  at   the  comi.iand   lansuai;e  of     SUPER'/YI.BUR.       Time  does 

not  allov.'  a  great  ar.iount  of  detail  on  eacli,  so  I  v;  i  1  1  attempt  to  Ki  i  t 
the  hi^h  points. 

(foil   12.5)  :  V. 

A  sinr, le  command  can  address  more  than  one  \.'orking  file.  I  can  say 
chan?;c  'A'  to  'B'  in  Temp  A  and  Temp  B  and  Temp  C  and  Temp  D  and  Temp 
E,  etc.  J\\c  chanr;e  cofuniand  \,ou  1  d  iviake  the  ciiaru;e  in  all  of  them.  lie 
also  allo\/  comiiiands  to  operate  on  perrnanent  storage  -  you  can  say  RV\', 
FROI'.  DATA5ET.     You  don't  say  use  and  run. 


tlic   Line  Cor.-i  lends   (foil  13) 


TIiG  first  cor.ii.iariu  is  collect.  Collect  (abb  rff  v  i  a  tecJ  col  or  c)  is  the 
rG<^uGi,t  to  ei'.  tcr  data  start  I  n,^  at  a  sijcclfied  line  number,  optionally 
specifyins  trie   increi.ient  by  i/hlcli   ti.e   line  number  should  increase. 

Tlie  system  v/ill  proi.ipt  v;itii  the  line  numbers  or,  v/itli  the  unnumbered 
option,  r.ie  re  1  y  unlock  tlie  keyboard  for  entry. 

If  directed  to  start  collecting  input  at  a  line  v/iilch  already  exists, 
Supe r'v/y  1  b u r  will  add  an  increment  to  the  number  you  specified  and 
besin  collecting  just  after  the  specified  starting  point. 

An  option  of  collect  \/hich  Is  not  on  the  foils  Is  The  command  option 
of  collect.  If  you  enter  collect  temp  A  command  shiOv  dsns  on  vol, 
v/hat  \;ould  fiave  printed  on  the  terminal,  from  the  command  sliow  dsns  on 
vol,  is  put  into  v.-orklng  file  A.  Any  command  can  be  done  on  ti'.e 
collect  command  except  another  collect  comr.iand  or  one  v;hich  destroys 
the  temporary  the  output   is  directed  to. 

Insert,   delete,   and   replace  do  \.'l^at  you  i.'ould  expect. 


c: 


The  short  form  alluded  to  at  tiie  bottom  of  the  foil  refers  to 
convention  that  a  line  number  folloi/ed  by  text  (entered  as  a  command) 
is  an  addition  or  rep  1  aceivien t  of  that  line  in  the  default  working 
file,  A  line  number  v.'ithout  text  is  ta[;en  to  be  a  request  to  delete 
that   line   In  the  def  au  1  t  i.'or  k  i  n^;  file. 


Intra- line  Editing:   (foil  11;) 

The  char.^^e  cor.u.icind  takes  any  strins  or  pattern  definition  (as 
described  in.  the  first  fev;  foils)  or  coUir.in  replacenent  of  the  form  CI  I 
5/7  TO  or  colunn  rep  1  acei.ien  t  of  the  forr.i  Cli  5  TO.  The  replacenent  can 
be  a  quoted  striii'^  or  th.e  vord  ilLX  follo\.ed  by  hexidecinal  dl^^its  or 
an  i  nc rcncn ted  inte:;er  (of  th.e  form  Cil  73/CO  to  IT  +  iO)  or  thie 
reserved  v;ords  UPF'ER  (r.icanin^  translate  to  upper  case)  or  LOl.'EPx 
(rr.eanins   translate   to   lo\/er  case). 

\le  also  can  use  a  transferred  replacement  \;here  the  replacement  data 
can  exist  as   lines  of  the  file. 

\le  also  can  specify  n^ore  than  one  change  to  be  made  at  the  saiiie.  time 
v/ith   the  Ai'jD  option.  . 


liote  that  in  the  first  example 
same  leni^tli  as  tar:-,et  strings  with 
line  as  d  i  rected .  ^  - 

The  first  cor.;mand  changes  every 
s  tr  i  ni;   '  DEF  '  . 


replacement  strings  need  not  be  th.e 
the  system     sliifting     text     in  tfie 

occurance  of  the  string   'AB'    to  the 


The  second  example  v/ould  cliange  any  2  digit  number  contained  in 
columns   13/17   to  the  hexidecimal    string  UO^BFF. 

The  third  exai.iple  \.ould  change  the  string  XYZ  to  the  null  string  from 
any  line  v/here  it  started  in  colu.mp,  10  in  th.e  range  from  line  number 
UGO  uh.rougii  tiie  last  line  of  the  file.  This  v/oulu  remove  tlie  *XYZ''s 
and  shift   the   lines  accordingly. 

Th.e  fourtii  \/ould  insert  an  'X'  at  colui.in  i;)  in  ttiose  lines  containing 
tliC  string   'ALLE'   and  having  t\;o  zeroes   i  Pi  column  one. 

Ti;C.  f  i  1' Lh  \;oi;1(-  uclc.te  CGlui.iU  positlcii  i^/lu  and  Inseri:  in  tiieir  placi: 
a  s  1 13  sii . 

Th.e  next  to  last  is  an  example  of  a  transferred  replacement  v/here  the 
repl  acenx.'n  t  data  is  th.e  lines  containing  the  string  'XYZ'  in  line  500 
throLi;;h  last  and  the  target  Is  these  lines  containing  the  string  'ABC' 
in   the   line  ;:ero   through   line  k?;[) . 

And  the  last  v.hore  AB  is  replaced  by  DEF  and  125  is  replaced  by  uO  in 
lines  \.'hicii  do  not   begin  with  an  asterisk. 

Thie  modify  ccm.mr.nd  is  a  unique  metiiod  of  i.iuicing  changes  to  a  line  or 
groL.'p  of  lines  in  \.hich  tiie  syste.,)  prompts  \/ith  the  text  of  tlie  line 
and  ch  angles  are  itidlcatcu  by  i.iov  I  n.,  tlie  type  elcr.ierit  to  t-he  position 
to  be  acin;d  on.  Then  by  entering  a  code  letter  like  d  for  delete  or  I 
for  ,  insert  or  r  for  replace,  tu  name  just  a  cou[)le,  follo\.'ed  by  tfie 
data  to  be  inserted  or  th.e  ref.' 1  acemiMi  t  text.  Tlie  system  will  tfuMi 
update}  tiie  line  and  rcproiujt  until  ti.e  user  indicates  that  all  changes 
to   t  h < !  t    line  are  f  I  n  i  s  h c  cJ . 


- 1  'J  - 


(foil  15;) 


The  COPY  and  fiOVE  connands  can  operate  on  lines  in  one  working  file  or 
bct\/een  multiple  v.'orklrii^  files  or  bet\.'een  disk  data-sets  and  one  or 
more  vvorkliii^  files. 

The  'ditto'  option  specifies  hov;  many  times  the  data  that  is  NiOVE'ed 
or  COPY'ed   Is   to  be  repeated  at  the  destination. 

The  'AliD'  option  allov/s  specification  of  multiple  destination  (I.e. 
copy  i/5    to  5  TEi.P  A  AliL   lU  TEilP  B). 

The  'SiiORT'  option  requests  the  system  to  list  only  the  first  message 
from  the   'COPY'  or   'I;OVE'  command. 

Tlie  'AFTER'  and  'BEFORE'  options  can  be  used  to  specify  that  the  data 
is  to  be  liOVE'ed  or  COPY'ed  after  or  before  eaci-.  line  in  a  second 
ran^e . 

The  'COPY'  command  normally  does  not  allov;  interleaving  or  replacement 
of  lines  based  on  line  numbers.  The  'fiERGE'  option  v;  I  1  1  allov/ 
Interleaving  but  not  replacement.  The  'OVEflLAY'  option  allov/s  both 
Interleaving  and  repl  acei.ien  t .  The  first  exai.iple  then  v/ould  COPY  lines 
numbered  one  through  10  to  line  50. 


Tiie  second  example  v/ould  COPY  all 
th.e  end  of  the  default  v/orkln^'j  file, 
lines  containing  the  string  7hl03  to 


lines   in  the  data  set  SOURCE. A  to 
The  third  example  v/ould  liOVE  all 
the  end. 


ihe  last  example  \/ould  COPY  lines  nui.ibered  1  th.rough  50  to  line  15  and 
line  15  0. 

The  f.ERGE  and  OVERLAY  commands  operate  in  a  iiianner  sii.illar  to  COPY 
\/Ith  hERCE  and  OVElvL/'\Y  options  as  previously  explained. 

Tlie  li  s  c  coi;ii.iai:u  ca^ises  tiie  data  rcc^uestco  to  be  1  isceu  at  tiic 
terminal   or  optioiially  on   the  printer. 

The  POIR'T  ccr^manJ  operates  the  sai.ie  as  the  LIST  comt.iand  but  also 
resets   the  current   line  value. 

The  IvETRY  comi.:aiid  causes  the  last  cor,,mand  entered  to  be  prompted  In 
tlie  same  manner  as   the  modify  commancJ. 

The  C{;i.PAL.E  cor.ii.iand  matches  t\'o  ranges,  \/IthiOut  regard  for  line 
nui.ibcjrs,   and  notes  dissimilarities. 

Th.e  rei.iainoer  of  I  tci.is  arc  CLEAR,  SET,  and  SilG',.'  commands  for  various 
fairly   s  L  ra  i  rJit  f  or\;a  ru  options. 
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Tfie  data  set  commands.  (foil  17) 
(foil  If.) 


The  U.c  command  causes  a  d.sk  sot  to  be   loaded   into     a     working  file 
Any     commanas     operate  on  tiie  copy  of  the  data  set   in  v;orHnrf tor' 
All   characteristics  of  the  data  set  are  retained.  stor.^e. 

The  SAVC  command  unloads   the  contents  of  a  vorl-in-  f  n     t-r^       ^-   i  j 
set.     An   original   characteristics  which  are  norSve^rfdden'arr'osed! 

The     liESAVE     command     causes     the     vorklnp-  fii«  ^-^  t      •  < 

existing  data  set  with  the  dsnane   to  Le  scrliche^?        """'''''^^  ^'^^ 

Typically,  if  you  are  nir-ldng  changes  in  a  prosraw  vou  say  use  i-enn  v 
fron  data  set,   you  put   in  your  changes  and  say  resave.  " 

ca?al^°"  ^^r'?""  f"'^        °?  K^^'^  °"  t'''^  =nd  update  the 

catalog.  If  I  say  scratch  sor.ie  aata  set  on  catalog  it  -ill  -cra^rh 
the  data  set  and  take     t  out  of  cat-nWv^         if  '  scratch 

ta^^crrr^^tl--"^'-  W,c  1  u^s^^^  f  ?  '  tH;  fu^'.^io^n^  re^^  reT?rdo\h- 

i^pe:^^f^^:;a:^sr^^^;^e's^^^j^^^?:g!"^ 

The  SnOl;  DShAI-.ES  and  SilOii  I.EI .iiliRS  cor.ii.iands  1  i s  t  the  da ta  se  t s  or 
r.er.,bers  and  opt ,  ona  1  1  y  give  a  full  readout  sirular  to  the  Li'tVTOC 
FuKi.Ai   or  Lioii'DS  output  of   IEHLI3T.  LloiVlUC 

Jrecede'the'da!-;  scn-n:!  -"ows  an  auton.atic  index  level  or  levels  to 
pri.ceuo  tnc  data  set  nci.ies  used   m  any  coiiinand. 

The  SKT  VOLUI.E  coi.ir.iand  establ  ishes  a  default  vol  une  for  a  usf.r  -^nri 
with  the'defauir''/"              "°  ^"'"''^  to  pper:? 

defauJt'votu'ne'isrlra^y.''"     ''"'^  '^^^'^"^  t'-' 

^^n^di^^la^the  :^?:^enrs?;tu^''^rf?^-sp^crorthaJ-oiuJr-- 


(foil  10) 


Optionally  the  data  can  be  SAVE 'd' In  a  coded  format. 
Tl-ie  encoding  alcoritlici  is  the  al-oriM.r,         ,  ,  , 

for  classified  r.iaterial.  ^'-oruhni  used  by  the     State    Depa rtf.-.ont 

As     I     stated     carl  ier     thp  r  /t-T  ^„  i 

the  printer.  Our  HASp' interface  aHows  ROr?r?"'""''V'^  directed  to 
the  execution  of  any  batch  procran.  R°l-,E',n-  and  does  not  involve 

^^'tt:;m.^i^l^'':;:,rr^^^^  -     ^^e  systen\oin. 

^"tered.  '^'"^"^^'^     the     aata     up     to     the  last  con,,,and 

Autor.ujtic  recovery  of  qvcifon  f-.  ti 

out     and     sets  VOuVfS  u's       t  a     rre%V ' ^^^^ '         not     only  goes 

user  co,,,nands  and  options  such  as  tabs;  en;;?^  and'^T^'  ^^^^ 
ecc.  •'-N^;',  Lfi     and     voiune,  prefix. 

Automatic  settin::  of  user  options. 
Su|)erv/y  1  Liur  Took-     fr>K  •  . 

automatically  cells  thljt  ^th^r^ ':-L^?^::rtco°;rr?  f  1  ^  '  ^ 

"un:;  ro^°;;-,.1^-^  J-  -^^-covered  to  _ 

•-cioCL   )o  Co  I  leu  uuLonatlcal  1  y. 


remotl:  jgc  ent^v  ru::cTio:^s.    (foil  21) 


(foi 1  22) 

The  Rl/'il  cor.ir.ic-ind  causes  the  i.'orkln;^  file  specified  to  be  passed  to  HAGP 
for  execution. 

When  a  job  has  completed,  the  output  (either  all  or  a  specific  ddnane) 
can  bti  retricveci  by  Lise  of  tfie  FETCH  corni.iand.  The  output  is  placed  in 
a  v.'orkin^;  file,  and  any  editing  conir.iands  can  be  used  to  inspect  tlie 
results.  If  the  output  is  not  as  expected  (perhaps  compiler  errors), 
it  can  be  PLRGE'd  and  herice  never  get  to  tlic  printer.  This  facility 
results  ill  a  draf.v.tic  reduction  in  printer  load  and  paper  savings 
(perhaps  up  to  several  thousand  lines).  This  is  even  more  dramatic 
where  slov;  RJE  printers  are  involved. 

The  jobs  status  can  be  obtained  and  chan^ied  (internally  using  standard 
HASP  con,.mands)  after  ov;nerslnp  of   tlic  job   is  checked. 

Output  can  be  ROUTE'd  to  a  i-iASP  reirioto  station.  Also,  optionally  the 
SET  REiOTE  command  can  default  all   output  to  a  specific  remote. 

I  miglit  also  mention  th.at  our  Production  Control  personnel  make  heavy 
use  of  SUPERl.'YLDl'R.  The  usefulness  of  tlie  system  for  helping  in  the 
production  control   problen":   is  vie]]  proven. 


DOCLfiLia  PREPARATION     (foil  2^) 
(fo  i 1    25  ) 

Getting  into  document  preparation  capabilities,-  V/e  are  compatible 
with   I  Bfi '  s  ATS  ana  inany  of  tlie  conr.ie  rc  i  a  1  1  y  available  ATS  derivatives. 

The  system  allov/s  alignment  or  justification  of   the   right  margin. 

Lines  can  be  centered  or  positioned  at  the  right  or  left  margin. 

SUPER'.iY LCUR  supports  pagination  vyith  complete  page  lieadlngs  and  page 
footiiig/    iricluditig  separate  even  and  odd  heauings  and  footings. 

It  should  be  noted  that  all  commands  handle  underlining  or 
overstr iking  properly. 

The  system  also  includes  an  algorithm  \;hich  optionally  IIYPliEfiATES  text 
in  the  alignment  or  justification  process.  Our  most  common  use  of 
this  facility  is  in  a  mode  in  vvhiich  all  hyphenations  are  promi^ted 
before  being  included.  The  prompt  includes  an  indication  of  \;here  the 
algorittim  has  indicated  th:e  hyphen  should  be  plus  \/here  the  ideal  end 
of  line  would  be.  The  terminal  operator  can  then  accept  or  move  tfie 
hyphen;  or  reviev/  \j\\at  the  line  looked  like  originally  and  v/hat  the 
newly  formatted  line  looks  like;  or  that  no  tryphenation  of  tl'iat  word 
is  desired.  Our  experience  to  date  is  that  80  -  S5Z  of  the 
a  1  go r I thm i ca 1 1 y  derived  hyphens  are  correct. 

The  facility  exists  to  stop  tiie  listing  on  the  terminal  to  a  i  1  ov; 
changes   in   type  elements  or  paper  or  to   Insert  additlorial  text. 

All  listing  on  the  printer  can  request  special  forrns  or  trains.  All 
underlining  and  ove  rs  t  r  I !;  i  ng   is  liaridled  correctly. 

also  allu''S  for  au  toi...:.  1 1  c  generation  oi    tabic  of  coii  tents 
I'he   t  eciin  i  c^i.ic     r.iay     also     be     h.elprul     for     limited  index 


type  uata. 
geiie  rcj  t  i  oi  1 . 
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TiiE  fiACRO  FACILITY   (foil  50) 


Tiie  r.iacro  facility  is  really  a  conplete  pro;i;rar,ir;ii  ng  lan^^ua^e  v;h.ich  in 
ccn  j  unc  t  i  cn  v/ith  the  couf.iand  lan^;ua{;e  \.'e  liave  previously  discussed, 
constitutes  an  extremely  po\yerful  and  useful  addition  to  the 
SUPEK'./YLBUK  systei.i.  If  you  are  not  familiar  with  a  prografnming 
language  v/ritten  in  a  text  editor,  I  remind  you  of  the  CLIST  language 
of  TSO,  the  EXEC  file  language  of  CI-.S,  or  the  LOAD  FILE  language  of 
some  VjYLBUR'S  \/iiich  are  all  primitive  implementations  of  what  was 
truly  needed.  SUPEk'jYLBUR  offers  far  greater  pcv/er  and  flexibility 
than  any   lufi  maciiine  editor  to  date. 


(foil  31) 


Tlie  facility  lends  itself  to  proLlei.is  sucii  as  interactive  data  entry 
v/ith  validity  checkins  and/or  reformatting,  or  tlie  problem  of 
constructing  parar.ieter  cards  for  non-programmer  users.  The  macro 
facility  includes  the  'TYPE'  command  \;here  tlie  command  is  'TYPE'  (or 
t)  follov/ed  by  any  ma  t  her.ia  t  i  ca  1  expression.  Super\;yl  bur  handles 
floatins  point  and  exponential  notation  and  does  arithm.etic  to  15 
sisnif  leant  diiiits,    tfiereby  providin<3  a  desk  calculator  capability. 

There  also  is  tlie  SET  COi  iliAi'^D  facility  i.'iilch  gives  you  the  ability  to 
add  your  o\;n  commands  or  synonyms.  You  v.'ould  enter  Set  command  A  : 
some  command  ( s ) .  Then  \/hen  you  type  'A'  the  comi.iand(s)  v^'ill  be 
executed.  Any  commands  that  you  set  are  recovered,  by  the  sai.ie 
recovery  r.iechan  i  sm.s  discussed  earlier. 

The  macro  language  has  variable  names  formed  by  any  IC  char 
combiriation  of  a  1  ph.anunier  I  cs  and  periods.  You  can  get  nice  readable 
variable  names.  They  are  not  typed  variables  and  can  contain  either 
strings  or  num.be rs. 

Data  can  be  entered  as  integers  or  as  decim.als  or  as  exponents.  Any 
number  that  is  going  to  print  larger  tlian  IQ  digits  is  automatically 
converted  to  exponential  forr.i. 

Conditional  branching  is  cor.iplete.  The  macro  syntax  includes  an  if, 
else,   structure.     There   is  a  match  operation. 

There  is  tlic  full  ability  to  read  or  write  from  tiie  terminal  and 
tliat's  extended  so  that  you  can  specify  your  o\:n  proi.ipting. 

Tliero  is  the  full  ability  to  read  or  \;rlte  from  v/orklng  files.  They 
can  be  addressed  v/ithi  an  IMI^UT  and  an  OUTPUT  statement  or  an  li;PUT  and 
an  ij ; ' I  . .  I      s  L a  L Ci    1 1  L  u  i"  a i  i y  u  v    c  i ^ ^   c o i  .. . la i  i (.» i>  ^.^  i    L i  i c    c l , ",  t  e i  l c  r  , 

You  can  preceed  any  command  \i\th  the  QUIET  option.  That  stops  all  but 
probujm  error  r..cssages  fro;.i  being  output  on  the  teriviinal.  if  you  are 
developing  a  macro  tiiat  you  are  going  to  have  scm,eonc  use  v.ho  doesr^.'t 
understand  coi.iputers,    you  can  mask   the  responses. 

Iiany  functions  are  provided,  but  time  docs  not  a  1  1  ov;  a  thorough 
ex[:)  1  ana  t  i  on  of  th.em.  Suffice  it  to  say  that  futictlons  are  included 
provIditK,  a  coi,iplete  SLimiiary  of  data  h.aving,  to  do  \.  I  th  tlio  terminal 
sesslcjn,  such  as  tlic  date,  tli.ie,  day  of  tfie  v;eck,  etc.  Also  many 
string  and  numeric  functloiis,  for  excii.i,-)lc  SUBGTklilb,  II.T'E)',  alsolute 
valuer,  etc.  In  adult  Ion,  tliere  are  conversion  functions  for  liex  to 
string,,  strlfig  to  number,  etc.  And  lastly,  those  functions  needed  for 
access  to  ti;e  \.'orki:ig  flics,  such  as  .LIi';E(i)  (returris  the  text  of 
lint-    i)   or   .  Cir..'';Li;T  (\.' )    (current   line  I'lLimber    In  v.O. 


SYSTuf,  cons  I  DERATI  C;:G.      (foil  5C) 


(foil  5:.) 

Supc-rwylbur  runs  under  0/S  flVT  or  fiFT  v/ith  HASP  5.1. 

The  system  run  under  TSC   (as  a  ccnr.and)  or  outside  ISO.     All  code 

in  the  systcr.i  is  fully  re-entrant,  and  placement  in  the  TSO  link[)ack 
or  the  0/S  linl^pack  t.'ould  allov;  concurrent  use  as  a  command  and 
separate  task.  l.'e  currently  can  run  under  Vo2  release  1,  but  tfie 
llASP'r   interface   is  not  yet  complete. 

Support  for  ASP  and  VSl  (as  a  CRJE  pi ug-compatabl e  replacement)  are, 
unden/ay  and  VSAii  and  VTAIl  v;ill  be  tackled  v/hen  we're  sure  tliey  really 
v/o  rk . 


(foil  39) 


The  systei.i  is  written  to  support  1  to  250  simultaneous  users  and 
support  is  practical  for  150  to  200  vnth.out  fully  saturatir^'i  a  1C5/C 
CPU  v.'liile  providinii  response  tin]e  mostly  under  one,  second. 

The  cycles  taken  arc  his'-ly  dependent  on  number  of  terminals  and  v/orl; 
bein£j  done,  but  CPU  usa;::;e  of  about  C-lOr^  of  a  C5  \;ou1d  support  about 
50  teri.iinals. 

The  system  will  Iiandle  about  30  terminals  at  170K  plus  the  terminal 
interface   (MILTEIi)  at  about  7  0k. 

An  overlay  structure  based  on  the  HASP  overlay  teciinique  allov/s  pa^eu 
code  for  lov;  activity  functioiis,  and  97  overlays  are  currently  used. 
Tiie  overlay  usai^e  is  r-icasured,  and  tuning  can  maintain  good  response 
v.'itii  a  large  ai.iount  of  paged  code. 

(foi 1  hO) 

U'hen  run  under  T50,  tiie  terminals  are  those  supported  by  TCAM.  With 
MILTEN/  \.'hicli  is  an  EXCP  level  teleprocessing  system  in  use  at  some  50 
installations  for  over  five  years,  support  exists  for  EDCCIC  or 
correspondence  27Ul's,  teletype  model  35,  55  and  37,  and  those 
countless  teletype  compatables. 

(foi  1  i-rl) 

As  you've  seen  v;e  iiave  i'ull   support  for  the  0/S  catalog. 

Any     direct  access  device  can  be  used  for  paging  or  periiianent  storage. 

RPS   is  used  where  available. 

i;uiti,>ie  CUr-Zr. ".'.'L^LT.  pa^^  flics  can  e.;Ist  on  saf.c  or  different 
devices. 

The  system  includes  570   instructions  only  \/iien  generated  for  a  570. 


SUPERWYLBUR 


o  INTERACTIVE  TEXT  EDITING 

o  REMOTE  JOB  ENTRY  &  RETREIVAL 


o  DOCUMENT  PREPARATION 


o  MACRO  FACILITY 


o  SYSTEMS  CONSIDERATIONS 


INTERACTIVE  TEXT  EDITING 


o  ENGLISH  LANGUAGE- LIKE  COMA/lAND  STRUCTURE 

°  UPPER  CASE  ONLY  OR  UPPER  AND  LOWER  CASE 
INPUT  OPTION  FOR  EACH  USER 

o  0  TO  255  CHARACTERS    PER  LINE 

°  SEVERAL  THOUSAND  LINES  PER  WORKING  FILE 
o  MULTIPLE  WORKING  FILES  FOR  EACH  USER 


FOIL  h 


FACILITIES  FOR  ADDRESSING  TEXT 


LINE  NUMBERS  (8  DIGITS  :DDDDD.DDD) 


I.E.  10 

150/250 

10,  150/250,  400,  600/lAST 
FlRST/50,  1000 


CURRENT  LINE  POINTER  ■ 
1  r  r!iPDrMT//inn 


RELATIVE  ADDRESSING 

1.  E.       FIRST  +  3 

100-7/  150+5 


o  CONTENT 


CHARACTER  STRINGS 


I.E.  'HAPPY' 
'DO'  7 


STARTING  COLUMN 
■SAVE'    lfl/2n      CONTAINING  COLUMNS 
'DATA'  7,  15/30  BOTH 


FOIL  7 


o  CONTENT 


CHARACTER  CLASSES 


ANY 

DIGIT 

LEHER 

UPPER 

UPLOW  'string' 


PUNCTUATION 

BOL 

EOL 

BLANK 

HEX  'hex-string' 
EMPTY 

BELOW  'string' 
ABOVE  'string' 


-  ANY  CHARACTER  INCLUDING  BLANK 

-  ANY  DIGIT  (0  THRU  9) 

-  ANY  ALPHABETIC  CHARACTER 
(UPPER  OR  LOWER  CASE) 

-  ANY  UPPER  CASE  ALPHABETIC  CHARACTER 

-  ANY  STRING  WITH  'string'  CHARACTERS 
EITHER  UPPER  OR  LOWER  CASE  CAT'  FOR 
At,  AT,  at,  aT) 

-  PUNCTUATION  CHARACTERS 

-  BEGINNING  OF  LINE 

-  END  OF  LINE 

-  BLANK  CHARACTER  '  '  OR  BOL  OR  EOL 

-  CHARACTER  STRING  EQUIVALENT  TO  THE 
'hex-string' 

-  BLANK  LINE 

-  STRING  BELOW  'string'  IN  COLLATING 
SEQUENCE 

-  STRING  ABOVE  'string'  IN  COLLATING- 
SEQUENCE 


S0A1E  "string'       -  OCCURRENCE  OF  ANY  ITEM  IN  'string' 


1.  E 


DIGIT  10 


,F0  I  L 


o  CONTENT 


BOOLEAN  COMBINATIONS  OF  STRINGS  AND  CHARACTER  CLASSES 

PAHERN  ORIENTED  OPERATORS 

AND 

OR 

NOT 

DUPLICATION  FACTOR 

CONCATENATION 

THRU 

1.  E.     DIGIT  AND  NOT  ('8'   OR  '9') 

(  DIGIT'2   OR  UPPER*2  )  DIGIT  '-' 
DIGITM 

SET  OPERATORS 
UNION 

INTERSECTION 

COMPLEMENT 

SET 

I.E.        'OPEN'  16   INT  'INPUT' 


FCI  L  9 


INSTANCES  OF  LINES 

ORDINALS    1ST,  2ND,  3RD,  NTH 
OF 

AFER 

■  BEFORE  ^  ^ 

EVERY      ^  ■ 
BETWEEN 

START  : 

I .  E.       3RD  AFTER  'ABC  1 

EVERY  2ND  AFTER  50TH  OF 


COMBINATIONS 


'BALANCE'  10/30  IN  200/500 

'ABC   7,  40,  72  IN  FlRST+3/25 

'RALPH'    10  IN  'GEORGE'  28  IN  200/LAST-l 

'RALPH'    10  !NT  'GEORGE'  28  IN  200/LAST-l 

1ST  AFTER  'Ti\V  10  IN  'FLAGA'  16 

IN  'FLAG AON' 21/ LAST  IN  EVERY  1ST  ARER  'SYMBOL' 


SUPERWYLBUR  COMMANDS 


SlNGIi  COMMAND  MiAY  ADDRESS  MORE 
THAN  ONE  WORKING  FILE 


C0MK1ANDS  MAY  ADDRESS  FILES  ON 
PERMANENT  STORAGE  AS  WELL  AS 
WORKING  FILES 


LINE  COMIVIANDS 

COLLECT  <lineno>  <BY  increment> 

INSERT     lineno  <!ineno2...  linenon>  <DITTO> 

DELETE     range  <L1ST> 

REPLACE      range    <D1TT0>  <L1ST> 

SHORT  FORM  FOR  INSERT,  DELETE,  REPLACE 


o  INTRA-LINE  EDITING 

o  CHANGE  target  TO  replacement 

WHERE  target:     STRING  OR  PA  HERN 

,  COLUMN  REPLACEMENT 
COLUMN  INSERTION 


replacement:       QUOTED  STRING 

HEX  string 
.    INCREMENTED  INTEGER 
UPPER  and  LOWER 


TRANSFERRED  REPLACEMENT 
AND 

i.e.      CHANGE   'AB'   TO  'DEF' 

CH  DIGIT*2    13/17    to  HEX  404BFF 
CH  'XYZ'   10  TO   "    IN  400/  LAST 
CH  10  TO  'X'    IN   'ABLE'    IN   '00'  1 
CH  14/  16  TO  '/' 

CH   'ABC  USING   'XYZ'    IN  500/ LAST  IN  0/ 499 
CH   'AB'  TO   'DEF'   AND   '123'   TO  '89'  IN' 
NOT  '*'  1 


o  MODIFY 


o  COPY  and  MOVE 


D  ITTO 

AND 

SHORT 

AFTER 

BEFORE 

MERGE 

OVERLAY 


I.  E.     COPY  1/10  TO  50 

COPY  ALL  FROM  SOURCE,  A  TO  END 
MOVE   74103'  TO  END 
COPY  1/30  TO  15,  150 


o  MERGE 


o  OVERLAY 


LIST  .     .  ,  , 

POINT  .  ^:    ,  : 

NUMBER 

RETRY 

COMPARE 

CLEAR 

SET  UPPER  -       SHOW  CASE 

UPLOW 

SET  LfNGTH  ,  SHOW  LENGTH 

SET  TABS  SHOW  TABS 

SHOW  COLUMNS 
SHOW  SIZE 
SHOW  STATE 


DATA  SET  MANAGEMENT  COMMANDS 


P  0  I L  17 


USE 

SAVE 

RESAVE 

SCRATCH 

RENAME 

CATALOG  ;  ^ 

RECATALOG 

UNCATALOG 

SHOW  DSNAMES  ,  '  , 

SHOW  MEMBERS 

SET  PREFIX  SHOW  PREFIX 

SET  VOLUME      "      '  SHOW  VOLUME 

SHOW  SPACE 


ACCESS  TO  BOTH  SEQUENTIAL  AND  PARTITIONED 
0/S  DATA  SETS 

COMPRESSED  DATA  SET  STORAGE 

ENCODED  STORAGE  FORMAT  FOR  SENSITIVE  DATA 

HIGH-SPEED  PRINTER  LISTINGS 

AUTOMATIC  RECOVERY  OF  SYSTEM  FAILURES 

AUTOMATIC  SEHiNG  OF  USER  OPTIONS 

ABILITY  TO  MODIFY  PREVIOUS  COA/IMAND 


REMOTE  JOB  ENTRY  &  RETRIEVAL 


JOB  SUBMISSION 

OPTIONAL  RETRIEVAL  OF  OUTPUT  AT  TERMINAL 

ALL  EDITING  COMMANDS  AVAILABLE  TO  SCAN  OUTPUT 

JOB  STATUS  inquiry'  \ 

FACILITY  FOR  CHANGING  JOB  STATUS 

OUTPUT  MAY  BE  DIRECTED  TO  A  REMOTE  STATION 


DOCUMENT  PREPARATION 


FOIL  7.'4 


o  alignmefnit  or  justification  of  right  margin 
o  centering  and  positioning  of  lines 

1 

o  automatic  pagination  WITH: 

A)  PAGE  NUMBERING 

B)  PAGE  HEADINGS 

C)  PAGE  FOOTINGS 

o  FULL  SUPPORT  FOR  UNDERLINING  AND  OVERSTRIKING 
o  OPTIONAL  HYPHENATION 

o  SUPPORT  FOR  SUSPENDING  OUTPUT  IN  ORDER  TO: 

A)      CHANGE  TYPE  ELEMENTS 
■    B)      CHANGE  PAPER 
C)       INSERT  TEXT  . 

o  ABILITY  TO  LIST  ON  HIGH-SPEED  PRINTER  (WITH  SPECIAL 
FORfviS  AND  TR-MNS)  ALL  UNDERLIN ING  AND  OVERSTRIKING 
INCLUDED 

o  AUTOMATIC  TABLE -OF -CONTENTS  GENERATION 


FOI  L  2i; 


MACRO  FACILITY 


I 


Ffill.  3C 


USEFUL  FOR  DATA -ENTRY  VALIDITY  CHECKING 
AND  REFORMAniNG 

USEFUL  FOR  AUTOMATIC  CONSTRUCTION  OF  JCL 
AND  PARAMETER  CARDS  FOR  NON  -  PROGRAMMERS 

USEFUL  AS  A  DESK  CALCULATOR 

ABILITY  TO  ADD  USER-DEFINED  COMMANDS 
AND  SYNONYMS 

ABILITY  TO  EXECUTE  PRE -STORED  COMMANDS 
NUMBER  AND  STRING  VARIABLES 
CONDITIONAL  BRANCHING 
ABILITY  TO  READ  OR  WRITE  TERMINAL 
ABILITY  TO  READ  OR  WRITE  WORKING  FILES 
NESTING  OF  MACRO  CALLS 


SYSTEMS  CONSIDERATIONS 


RUNS  UNDER  0/S  MVT,  MFT  WITH  HASP  3.1 


RUNS  UNDER  TSO,  OUTSIDE  TSO,  OR  BOTH  \ 
PLANNED  SUPPORT  FOR  ASP,  VS2,  VSl,  VSA/Vl,  VTAM 


o  SUPPORT  1-250  SIMULTANEOUS  USERS 

o  RESPONSE  TIME  MOSTLY  UNDER  ONE  SECOND  . 

o  LITTLE  OR  NO  EFFECT  ON  BATCH  THROUGHPUT 

o  MINIMUM  CORE  REQUIREMENTS  APPROXIMATELY  170K 

0  PAGED  CODE  FOR  LOW -ACTIVITY  FUNCTIONS 

P  n I  1 


o  SUPPORT  FOR: 

>  .  ■     ■     ■  - 

A)  EBCDIC   OR  CORRESPONDENCE  274rs 

B)  TELETYPE   MODEL  33,  35,  37 

C)  TELETYPE  COfviPATiBLES 


SUPPORTS   0/S  CATALOG 


SUPPORTS  ANY  DIRECT  ACCESS  DEVICE  FOR 
PAGING  AND  PERMANENT  STORAGE 


SUPPORTS  ROTATIONAL  POSITION  SENSING 


SUPPORTS  MULTIPLE  PAGING  FILES 


4 


4 


4 


ROSCOE 


I 


C13-052-201 
Software 


ROSCOE 
Applied  Data  Research,  Inc. 


A  remote  job  entry  system  that  provides  a 
conversational  approach  to  program  prepara- 
tion, testing  and  maintenance  via  remote 
terminal  facilities.  It  is  usable  on  any  IBM 
System/360,  370,  303X,  4300.  or  com- 
patible computer  running  under  OS  or  OS/ 
VS. 

A  permanent  license  for  basic  ROSCOE  costs 
$29,000,  while  a  permanent  license  for 
ROSCOE/MVS  costs  $33,000.  Monthly 
licenses  for  these  are  $1,610  and  $1,840 
respectively. 

Currently  there  are  approximately  650  users. 


MANAGEMENT  SUMMARY 

ROSCOE  (Remote  OS  Conversational  Operating  Envi- 
ronment) is  a  low-overhead,  comprehensive,  on-line  pro- 
gram development  system  that  contains  a  wide  variety 
of  interactive  special  functions  not  found  in  IBM's  TSO 
(Time  Sharing  Option).  ROSCOE  can  be  installed  on  any 
IBM,  or  compatible,  computer  capable  of  running  the 
OS,  VSl,  SVS,  or  MVS  operating  system.  As  previously 
mentioned,  ROSCOE  competes  favorably  against  TSO. 
TSO  is  a  generalized  time-sharing  system  as  compared 
to  the  multi-functioned  ROSCOE.  ROSCOE  also  vies 
favorably  against  IBM's  CMS  (Conversational  Monitor 
System)  under  VM  (Virtual  Machine)  /370,  requiring 
significantly  fewer  resources  to  perform  comparable  tasks. 

ROSCOE  incorporates  a  wide  range  of  facilities  to  serve 
the  needs  of  application  and  system  programmers  as  well 
as  computer  users  who  are  not  programmers.  Some  of 
these  include:  full  on-line  data  entry  and  editing  facilities; 
an  efficient  library  system  for  permanent  data  storage; 
full  facilities  for  job  entry  and  job  output  retrieval  in 
any  OS/VS  system;  a  hierarchical  system  of  security 
features;  interactive  processing  for  performing  frequently 
used  functions;  synta.x  checkers  for  COBOL,  FORTRAN, 
PL/ 1  and  Job  Control  Language  (JCL),  and  a  monitor 
with  loading,  execution,  and  1/0  seryices  for  user-written 
programs. 

In  addition  to  the  many  standard  features  found  in 
ROSCOE,  some  additional  cost  options  are  available. 
COBOL/ ADE  is  a  structured  system  option  for  COBOL 
debugging,  and  MINIBASIC  is  a  special  implementation 
of  the  BASIC  problem-solving  language.  RTS  is  an  option 
that  can  be  implemented  for  problcni  solving  in  time- 
sharing mode.  The  latest  version  of  ROSCOE  contains 
improved  security  measures  for  data  protection,  as  well 
as  added  reporting  facilities  to  keep  an  accurate  account 
of  system  and  human  resource  utilization. 

USER  REACTION 

In  tlie  1978  Datapro  survcv  of  proprietary  software  users, 
20  respondents  rated  ROSCOE.  As  a  result  of  these 
ratings,  ROSCOE  earned  a  place  on  the  Datapro 
Software  Honor  RoW  for  the  second  consecutive  year. 
The  ratmgs  are  shown  in  the  table  below. 


[■  \ccllcnl 

(lood 

r-air 

Poor 

WA 

Overall  satisfaction 

11 

8 

I 

0 

3.5 

Throughput, 'L-liicicncy 

10 

10 

0 

0 

3.5 

l:ase  of  installation 

9 

8 

3 

0 

3.3 

Ease  of  Use 

12 

6 

2 

0 

3.5 

Documentation 

5 

1  1 

4 

0 

3.1 

Vcrulor  technical  support 

4 

1  1 

5 

0 

3.0 

Training 

3 

13 

3 

0 

3.0 

•Weighted  Aver.igc  on  a  scile  of  4  0  for  Excellent. 

Nineteen  (->!  the  20  respmulcnls  idcnlincd  their  computers: 
there  were  nine  S\siciii_370  Model  1 58's,  two  Model 
!3S"s.  two  Motlcl  14.S\,  two  Model  155's.  one  3032  proc- 
essor, otic  Ssstcin  Mm)  Model  50,  one  Model  6.S,  and  one 
ltd  .\S  5  ssstcin.  Nine  users  were  ruiniiiig  under  VSI, 
five  uiuicr  OS  WY'V,  tlirce  were  using  MVS,  and  two  had 
the  S\'.S  i)[)cratitig  system.  The  a\crage  ROSCOE  usage  X:> 


CHARACTERISTICS 

VENDOR:  Applied  Data  Research,  Inc.,  Route  206  Center, 
CN-8,  Princeton,  New  Jersey  08540.  Telephone  (609) 
924-9100. 

INITIAL  INSTALLATION:  June  1970;  current  version 
was  released  in  February  1979. 

CURRENT  USERS:  Approximately  650  as  of  June  1979. 

BASIC  FUNCTION:  ROSCOE  is  a  remote  job  entry 
system  that  provides  remote  terminal  users  with  full  access 
to  an  IBM  computer  under  OS  or  OS/VS  for  program 
development,  testing,  and  maintenance.  It  possesses  on-line 
data  entry  and  editing  facilities,  sopliisticated  security  capa- 
bilities, and  complete  data  managenient  facilities  tor  applica- 
tion and  system  programmers.  ROSCOE  provides  syntax 
checkers  for  COBOL,  FORTRAN,  PL/1,  and  the  JCL. 
There  are  a  structure  for  COBOL  debugging  and  a 
special  implementation  of  the  BASIC  language  processor 
available  as  options. 

OPERATION:  ROSCOE  is  loaded  and  terminated  through 
the  computer  operator  console  as  a  "never-ending"  job  in  a 
partition  or  region  under  IBM's  OS.  Numerous  programs 
can  be  developed  concurrently  from  multiple  remote  termi- 
nals under  ROSCOE,  with  an  Active  Work  Si)ace  (.AWS) 
associated  with  each  terminal.  A  conversational  command 
system  allows  the  user  to  manipulate  his  AWS  area  and 
library  files,  with  job  submis^sion,  initiation,  and  output 
recovery  all  controlled  at  the  remote  location. 

As  each  user  is  logged  into  the  system,  AWS  and  library 
storage  areas  are  assigned.  ROSCOE  drops  all  spaces  and 
blanks,  thus  reducing  library  storage  space  requirements. 

Ihe  AWS  handles  card-image  data.  Each  AWS  line  has 
an  internal  line  number  associated  with  it.  Manipulation 
or  editing  of  the  AWS  is  done  either  implicitly  by  line 
numl)€r  or  through  explicit  com crsalional  ROSCOE  com- 
mands. These  commands  permit  assignment  or  renumbering 
of  line  ruimbers;  display,  tnodification,. insertion,  or  deletion 
of  all  or  part  of  the  AWS  by  line  number;  character  string 
»  manipulation  for  single  or  multijjle  lines;  and  tab  settings 
so  that  remote  ke\ board  data  entry  Ls  automaticall\  placed 
at  user-specified  positions  in  the  designated  /VWS  line. 

The  User  Librarv  Ls  organized  into  named  data  sets  and 
provides  permanent  storage  facilities  for  user  data.  Indiv  idual 
data  sets  are  jirotccled  by  a  i)rcfi\  associated  with  the 
user's  ROSCOE  authorization  code.  Each  user  data  set  Ls 
manipulated  as  a  unit,  and  there  are  library  commands 
which  allow  the  transfer  of  complete  data  sets  frtmi  the 
AWS  to  the  library  and  vice  \ersa. 
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time  was  16.9  monihs,  with  nine  users  reporting  having 
had  ROSCOE  for  one  year  or  less  at  the  time  of  the 
survey. 

The  advantaces  checked  off  by  these  respondents  showed 
that  16  realized  savings  in  human  resources,  1 1  reported 
savings  in  system  resources,  10  judged  it  llexible,  and 
2  said  it  is  'inexpensive.  The  number  of  users  checkmg 
off  disadvantages  was  small  in  comparison.  Two  felt  it 
is  costly,  one  each  stated  that  it  is  complex,  uses  excessive 
resources,  and  lacks  key  capabilities. 

None  of  the  ROSCOE  users  included  any  comments  on 
their  returned  questionnaire  form,  obviously  feeling  that 
their  ratings  clearly  express  their  satisfaction  with  the 
product.  Looking  at  these  ratings,  one  notices  that  all 
the  fmal  weighted  average  ratings  are  3.0  or  better;  a 
solid  commendation  for  ROSCOE.  The  ratmgs  on 
documentation,  vendor  technical  support  and  trainmg 
show  that  some  improvement  could  be  realized  in  these 
categories. 

With  testimonials  in  the  form  of  the  submitted  ratings, 
which  returned  ROSCOE  to  the  Datapro  Software 
Honor  Roll  for  the  second  consecutive  year,  we  feel  that 
any  OS  or  OS/VS  installation  looking  for  an  effective, 
resource-savmg  conversational  monitoring  system  would 
benefit  from  evaluating  what  ROSCOE  has  to  offer.D 

The  data  sets  belonciiis  to  each  ROSCOF.  user  are  protected 
hy  a  hierarchy  of  methanisms:  the  user's  key  and  password 
(which  are  maintained  on  a  scrambled  file),  internal  protec- 
tion code,  and  prolcclion  groups  (optional).  1  hese  prevent 
unauthorized  access  or  modification  of  each  user's  data 
sets.  The  RO.SCOK  facilities  themselves  arc  secured  by  a 
system  of  user  exits  which  permit  management  to  define 
and  protect  sensitive  areas  on  a  site  basis. 

Frequently  used  se<iuences  of  ROSCOE  commands  can  be 
stored  in  the  User  Library  under  a  data  set  name.  Such  a 
sequence  of  commands  is  known  as  a  ROSCOE  conversa- 
tional procedure,  or  ROSPROC,  and  can  contain  a  certain 
amount  of  loRic  or  decision-making  capability.  Of  particular 
interest  c>  the  CALE  command  that  permits  one  ROSCOE 
procedure  to  call  another,  with  linkage  beginning  and  ending 
at  user-specified  statements  in  the  called  ROSPROC. 

Actual  control  o\er  the  running  of  users'  jobs  is  handled 
through  the  SI  H.MIT  command  and  the  Output  routine. 
Tlie  SI  BMI  r  command  enters  a  single  job  or  a  jobstream 
to  OS  for  batch  proce-ssing,  with  ajjpropriate  J(  E  either 
entered  through  the  remote  terminal  keyboard  or  fetched 
from  a  user  library  data  set  under  remote  terminal  control. 

The  Output  routine  |)ermits  the  ROSC  OE  user  to  view  an 
entire  job's  output  direcll)  from  the  system  queues,  it 
contains  coinm.uuis  to  f.icilitate  rapid  browsing,  willi  options 
to  place  selected  portions  of  the  output  in  the  AW'S  and 
to  purge  an  entire  job.  or  portions  thereof,  after  viewing. 

The  ROSCOE  I  ser  Services  are  a  set  of  major  sul)systems 
extending  the  bisic  ROSCOE  facilities.  All  of  these  services 
run  under  control  of  the  ROSCOE  Monitor,  a  standard 
facililv  with  services  for  loading,  execution,  scheduling, 
and  ROSCOE  I/O  ojieratioas.  The  M(niitor  can  accommo- 
date up  to  2S5  routines.  Amcmg  these  services  are  the 
svntax  checkers.  EIH/OE  for  on-line  execution  of  ADR's 
I  IBR  AKl  AN.  AMS  for  VSAM  data  management  functions, 
the  { Ol'^  routine  for  fetching  OS  data  sets  into  the  ANVS, 
St  I'ER/Al'  U>T  iiii.(lif\ing  and  verifviiig  direct-access  data 
sets,  ADK's  I  OOK  svstem,  and  a  series  of  applicalions- 
orii'iued  fdcihlies. 

For  use  b>  management,  systems  programmers,  and  even 
end  users.  R()S(  OE  produces  several  different  kiiuis  of 
accixinting  reports.    These  reports  can  describe  terminal 


activity  by  user,  project,  and  date;  ROSCOE  resource  and 
1/0  usage;  library  usage;  and  the  ROSCOE  system 
configuration.  There  is  a  set  of  user  exits  that  permit 
site-written  routines  to  supplement  or  replace  the  standard 
ROSCOE  reports. 

RTS  (ROSCOE  Interactive  Time-Sharing  Monitor)  is  an 
extra-cost  option  that  works  in  a  VS  environment  to  permit 
execution  in  time-sharing  mode  of  programs  placed  in  a 
special  time-sharing  library.  The  programs  can  be  written  in 
FORTRAN,  PL/1  or  BAL.  There  is  no  limit  on  the 
number  of  programs  in  the  library  nor  on  the  number  in 
concurrent  execution  at  any  time,  except  for  that  imposed 
by  storage  limitations.  A  program  to  be  executed  under 
RTS  is  first  debugged  and  tested  using  standard  ROSCOE 
facilities.  When  a  clean  working  version  is  obtained,  it  is 
put  in  the  time-sharing  library.  This  last  step  is  performed 
by  the  ROSCOE  system  manager,  who  creates  a  table  entry 
for  each  such  program  describing  its  name,  langtjage,  and 
file  requirements.  The  program,  without  modification  to  the 
original  code,  is  link-edited  with  a  time-sharing  front  end 
and  placed  in  the  library,  where  it  is  then  available  for 
on-line  ROSCOE  execution.  ROSCOE  then  passes  control 
to  RTS.  Using  its  own  command  language,  RTS  requests 
from  the  terminal  user  the  name  of  the  routine  to  be 
executed  and  places  it  in  execution  by  attaching  it  as  a 
subtask. 

Two  extra-cost  features  incorporated  into  a  recent  release 
of  ROSCOE  are  COBOL/ADE  and  MINIBASIC. 
COBOL/ADE  (Automated  Debugging  Environment)  is  a 
facility  for  dynamic  COBOL  program  verification  that 
provides  the  tools  and  a  carefully  controlled  environment 
for  easier  program  testing  and  debugging.  COBOL/ADE 
simulates  those  system  programmer  activities  that  are  prc^- 
grammable.  It  helps  the  applications  programmer  to  better 
identify  problem  areas  and  corresponding  diagnostic  actions 
to  be  taken.  It  also  assists  him  in  reading  memory  dumps 
and  tracing  system  control  blocks  to  obtain  relevant  infor- 
mition.  Failing  statements  in  a  COBOL  program  can  be 
located  through  the  use  of  COBOL/ADE,  and  it  is  all 
done  in  a  conversational  mode. 

MIMB.-VSIC  is  a  "code  and  go"  implementation  of  the 
BASIC  language  processor.  It  Ls  fully  interactive  and 
generates  diagnostics  during  both  compilation  and  execution. 

HARD  W  A  R  E  /  S  O  !•  T  W  ARE  R  E  Q  L'  I  -  » l'-  ^T  S :  A  n 
average  ROSCOE  system  can  be  installed  on  any  IBM  S\s- 
tem/if'*'.  37"'  30.^X.  4300.  or  compatible  computer  with  at 
least  5I2K  bytes  of  main  storage,  operating  under  OS.  \  SI. 
SVS.  or  MVS.  A  typical  6-terminal  IBM  3270  ROSCOE 
system  occupies  15()K  bytes  in  a  main  memory  partition 
or  region  including  OS  control  retjuirements,  but  exclusive 
of  syntax  checkers.  The  syntax  checkers  require  anywhere 
from  6K  to  I2K  bytes  each.  The  UTILITY  sul>system  requires 
about  30K  bytes,  which  can  he  shared  with  the  svntax 
checkers.  Each  additional  terminal  requires  about  2K  bytes 
of  main  memory  for  local  areas  and  buffers. 

ROSCOE  handles  terminals  capable  of  running  either 
BTAM  or  VTAM.  It  supports  such  hard-copy  devices  as 
the  IBM  2741  or  Teletype  33/35  as  well  as  locally  attached 
CRT  display  terminals  such  as  the  IBM  3270.  Both  local 
and  remote  3270's  with  printers  are  supported  by  ROSCOE. 

PRICINC:  ROSCOE  and  its  options  are  available  on 
permanent  license  with  a  single  payment,  3  annual  pay- 
ments, or  12,  24.  or  36  monthly  payments.  One  year  of 
maintenance  is  included  at  no  extra  charge,  and  subsequent 
maintenajice  is  available  on  1,  2,  or  3-year  terms.  Long-term 
leases  are  aLso  available. 
Some  of  the  basic  prices  are: 

Permanent  Monthly 
License  License 


ROSCOE  MVS 

ROSCOE 

RTS 

COBOL  ADE 
MINIBASIC 


$33,000 
29  000 
7.400 
5,000 
4,800 


51,840 
1,610 
410 
280 
260 
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ADR's  ROSCOE,  VOLLIE,  The 
LIBRARIAM/Online,  and  Meta- 
COBOL  are  improving  program 
and  programming  productivity 
through  online  program  develop- 
ment facilities,  testing  and  debug 
ging  aids,  security  and  auditing 
tools,  structured  programming, 
and  code-generation  programs. 


OPERATIONAL 
PRODUCTIVITY 

ADR's  LOOK,  ROSCOE,  and  The 
LIBRARIAN  are  maximizing  the 
effective  use  of  computer  hard- 
ware and  increasing  the  produc- 
tivity of  operations  personnel. 
These  systems  are  reducing  the 
cost  of  hardware  by  providing 
greater  efficiency  in  the  use  of 
existing  resources. 


MAINTENANCE  AND 

ENHANCEMENT 

PRODUCTIVITY 

ADR's  MetaCOBOL  and  The 
LIBRARIAN  are  reducing  the 
costs  and  increasing  the  reli- 
ability of  the  billions  of  dollars 
worth  of  programs  that  require 
continued  maintenance, 
enhancement,  and  conversion. 
As  much  as  80%  of  all  pro- 
gramming activity  is  typically 
directed  toward  this  area  alone. 


DOCUMENTATION  AND 

COMMUNICATIONS 

PRODUCTIVITY 

ADR's  On-line  ETC  is  automating 
the  production  of  documents, 
manuals,  and  other  communi- 
cations materials.  Automated 
System  Charter  (ASC)  and 
AGTOFLOW  II  are  providing  the 
practical  tools  for  producing  and 
maintaining  system-and  program- 
level  specifications  and 
documentation.  These  products 
provide  important  communica- 
tions links  between  technical  and 
non-technical  personnel. 


1 


ADR's  tools  for  online  program 
development  give  programmers 
direct  interaction  with  the  com- 
puter —  to  save  time,  increase 
productivity,  and  improve  the 
quality  of  programs 


A  remote  job  entry  system  for  OS 
and  VS  environments  that  provides 
conversational  facilities  for  program 
preparation,  testing,  and  mainte- 
nance. Originally  developed  to  pro- 
vide programmers  with  an  alternative 
to  preparing  programs  at  keypunches 
and  submitting  and  retrieving  their 
jobs  in  batch,  ROSCOE  now  serves 
both  application  and  system  program- 
mers, as  well  as  non-programmers,  in 
many  phases  of  their  daily  operations. 
ROSCOE  with  COBOUADE^''  (the 
COBOL  Automated  Debugging  En- 
vironment) can  further  assist  COBOL 
application  programmers  in  verifying 
and  debugging  their  programs  in  a 
conversational  environment.  Installed 
at  more  than  500  sites  throughout  the 
world,  ROSCOE  is  providing  users 
with  an  economical,  balanced  alter- 
native to  IBM's  TSO  and  VM/CMS. 


".  .  .  our  productivity 
has  increased,  our  pro- 
gramming effort  is  more 
efficient,  and  our  'vori^  is 
of  3  higher  quality  —  ail 
because  of  ROSCOE." 
.'Uemander  Metz,  Allisnz 
Insurance  Co. 


•  7  -r^  1  1  ' 

ADR's  comprehensive  online  program 
development  system  operational 
under  CICS  DOS/VS.  VOLLIE  offers  a 
sophisticated  interface  to  POWER/VS; 
complete  RJE  and  RJO  facilities;  imme- 
diate updates  to  The  LIBRARIAN  and 
to  the  DOS/VS  source  statement  and 
procedure  libraries;  Syntax  Checkers 
for  COBOL  and  JCL;  and  VOICE,  the 
Interactive  Command  Executor. 

VOLLIE's  advanced  Online  Library 
(the  OLL),  designed  for  optimum  ef- 
ficiency in  an  online  environment, 
provides  each  user  with  an  almost 
unlimited  permanent  and  secure  data 
storage  area.  Data  in  the  OLL  are  pro- 
tected from  unauthorized  access;  sys- 
tem functions  can  be  restricted  on  a 
user-by-user  basis  by  site  management. 


•  ro<nicr.;v<<. '/  •■•-.•m-'j,  .nu.i 


Today,  online  programming  systems  are 
dramatically  increasing  programming  pro- 
ductivity —  not  only  by  decreasing  turn- 
around time,  but  by  providing  many  psycho- 
logical benefits  as  well.  ROSCOE  provides 
such  benefits  for  OS  environments.  Because 
of  its  efficient  mode  of  operation,  remarkably 
low  overhead,  and  ease-of-use  by  both  pro- 
grammers and  non-programmers,  ROSCOE 
is  winning  worldwide  acceptance  as  the 
system  for  online  conversational  program 
development. 

Gntil  very  recently,  Germany's  Allianz  In- 
surance Company,  the  largest  insurance  com- 
pany in  Europe,  was  using  conventional 
batch  procedures  for  writing  and  maintaining 
programs.  Allianz  realized  it  would  be  more 
efficient  if  their  100  programmers  could  have 
direct  online  access  to  the  computer.  There- 
fore, the  company  organized  a  team  of  their 
DP  experts  to  evaluate  ADR's  ROSCOE  and  the 
other  leading  time-sharing  terminal  system. 


Alexander  Metz,  Allianz's  Chief  Systems  Pro-  ] 
grammer,  states  that,  "After  a  careful  com- 
parison,  we  found  ROSCOE  best.  ROSCOE 
is  a  system  with  a  simple  language,  good 
data  set  organization,  data  security  —  and  a 
small  CPU  load. 

"One  of  the  big  advantages  of  ROSCOE  is 
that  our  programmers  can  now  see  the  Si 
results  of  their  efforts  immediately.  They  | 
enjoy  their  work  so  much  now  that  more  , 
work  gets  accomplished.  After  we  installed 
ROSCOE,  the  number  of  jobs  that  our  pro- 
grammers ran  rose  from  400  to  800  per 


day.  The  overall  result  has  been  that  our  pro- 
ductivity has  increased,  our  programming 
effort  is  more  efficient,  and  our  work  is  of  a 
higher  quality  —  all  because  of  ROSCOE. 
It's  beautiful!" 

When  Carte  Blanche,  the  well-known  interna- 
tional travel  and  entertainment  credit  card 
company,  expanded  its  Information  Services 
Division  in  1976,  it  required  a  programming 
system  that  would  allow  their  programmers 
to  work  efficiently  at  remote  client  locations. 
Explains  Kenneth  Panzarella,  Information 
Services  Division  Vice  President,  "We 
looked  at  ROSCOE  as  well  as  competing 
systems.  After  comparing  cost,  productiv- 
ity gains,  and  CPG  overhead  requirements, 
we  chose  ROSCOE. 

"ROSCOE's  online  programming  capabil- 
ities allow  our  programmers  to  work  at  peak 
efficiency  regardless  of  location.  Our  pro- 
grammers are  happier  and  they  have  a  higher 
degree  of  professionalism.  ROSCOE  keeps 
costs  down  and  makes  us  more  competitive. 
In  fact,  ROSCOE  has  increased  our  ability  to 
do  a  better  job  for  both  our  service  bureau 
customers  and  Carte  Blanche.  We're  posi- 
tive we  made  the  right  choice." 

One  of  the  three  largest  banks  in  the  New 
Orleans  area  —  Hibernia  National  Bank  — 
prides  itself  on  its  ability  to  provide  highly 
personalized  services  to  its  customers  despite 
rapidly  increasing  paperwork  costs.  To 
increase  its  programming  productivity, 
Hibernia  installed  ROSCOE.  Don  Clark.  Data 
Processing  Division  Vice  President,  discusses 
the  reasons  why.  "Our  30  programmers  and 
analysts  are  too  highly  paid  to  be  spending 
time  keypunching  and  running  around  trying 
to  find  program  decks.  To  cut  that  time  and 
get  out  of  the  card  business,  we  needed  the 
ability  to  interact  directly  with  our  com- 
puter. The  logical  solution  was  ROSCOE. 
Within  a  week  after  ROSCOE  was  installed, 
we  could  see  the  change.  The  individual  who 
had  been  in  a  laborious,  archaic  card  en- 
vironment had  his  own  online  terminal.  In 
effect,  ROSCOE  gave  him  his  own  com- 
puter —  for  online  maintenance,  develop- 
ment programming,  and  remote  testing.  In 
other  words,  ROSCOE  helps  out  in  nearly 
every  programming  function.  Everybody 
wants  to  use  ROSCOE  now." 

ADR's  VOLLIE  is  a  comprehensive  system  for 
online  program  development  in  a  CICS 
DOS/VS  environment.  In  addition  to  com- 
plete RJE;RJO  facilities  and  a  sophisticated 
interface  to  POWER.  VOLLIE's  powerful  set 


of  editing  commands  provides  programmers 
with  efficient  tools  for  program' development 
and  maintenance. 

Hollywood  Federal  Savings  and  Loan  of 
Hollywood,  Florida,  has  found  VOLLIE  to  be 
invaluable  in  the  continuing  development  of 
their  banking  system. T.V.  Jarratt,  Vice  Presi- 
dent of  Data  Processing,  notes  that, 
"VOLLIE  gives  us  data  entry  and  editing 
facilities  which  increase  our  productivity. 

"For  example,  when  one  of  our  online 
systems  blew  up,  we  didn't  know  which  pro- 
gram in  the  system  caused  it,  because  some 
of  the  pointers  were  destroyed.  To  diagnose 
the  problem,  we  displayed  the  programs 
that  had  been  running  and  used  the  SCAN 
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command  to  find  a  message  we  had  seen  in 
the  dump.  By  scanning  for  that  message,  we 
were  able  to  find  the  two  bad  programs  out 
of  200  programs  in  the  system.  It  would 
have  taken  us  hours  to  sit  down  with  a 
listing  and  find  that  message." 

"Other  editing  features  help  us  too,"  adds 
John  Gregory,  Systems  Programmer.  "We 
can  duplicate  sections  of  code  within  a 
module  any  number  of  times  without  errors 
because  if  we  have  it  right  the  first  time,  it 
will  be  right  every  time. 

"Even  when  we  scan  through  1000 
statements,  VOLLIE's  response  time  is  2-3 
seconds.  Any  other  applications  that  we 
have  would  take  2-3  minutes.  And  VOLLIE 
doesn't  degrade  anything  else  in  the  system. 
ADR  must  be  using  some  really  good  tech- 
niques in  order  to  get  VOLLIE  to  perform 
the  way  it  does." 
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3R's  software  tools  for  COBOL 
de  generation  and  online  source 
ogram  management  allow  the 
velopment  of  programs  in  a 
orter  time  and,  in  the  long  run, 
oduce  programs  which  will  require 
is  maintenance 


)R's  COBOL-oriented  software  prod- 
i  for  developing  and  nnaintaining 
^grams  at  either  the  conventional 
)BOL  or  higher  level.  MetaCOBOL 
now  in  use  at  more  than  450  sites 
oughout  the  world  for  structured 
Dgrannming,  for  code  generation, 
conversion  from  one  COBOL 
ilect  to  another,  for  natural  inter- 
:ing  to  a  data  base  management 
stem,  for  auditing  for  adherence  to 
:al  programming  standards,  for 
stematic  testing,  and  for  dozens  of 
"ler  applications.  MetaCOBOL  is 
zing  countless  hours  of  program- 
ng  effort  while  making  dramatic  im- 
3vements  in  overall  program  quality. 
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)R's  low-overhead,  online  source 
inagement  system  designed  for  use 
h  The  LIBRARIAN  at  OS,  DOS,  and 
'  installations.  LIB/OL  is  operational 
der  IBM  and  non-IBM  telepro- 
.sing  monitors  including  CICS,  TSO, 
SK/MASTER,  DATACOM,  and 
iSTI.  LIB/OL  allows  the  display  and 
mediate  update  of  programs  stored 
a  LIBRARIAN  master  file.  LIB/OL 
o  provides  extensive  editing  and 
E/RJO  facilities,  and  the  ability 
display  the  status  of  all  jobs 
the  system. 


"If  it  were  not  for 
MetaCOSOL,  our  efforts 
to  deveJop  a  mas^iive 
online  banking  system 
would  have  been  in- 
calcuiabiy  more  dif- 
ficult." Peter  Aebischer, 
Swiss  Sank  Corooration 
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The  number  of  debugged  program  state- 
ments produced  with  a  given  effort  over  a 
given  period  of  time  is  the  ultimate  measure 
of  program  development  productivity.  A 
COBOL  preprocessor  which  can  amplify  the 
benefits  of  a  COBOL  compiler  (just  as  the 
assembler  and  its  successor,  the  compiler, 
amplified  the  original  machine  code  concept) 
can  result  in  a  many-fold  increase  in  program 
development  productivity. 

MetaCOBOL  is  such  a  preprocessor.  Gnlike 
any  other  COBOL  programming  aid, 
MetaCOBOL  also  offers  the  unlimited  power 
of  a  true  macro  language.  With  MetaCOBOL, 
users  can  extend  COBOL  for  nearly  any  pur- 
pose while  virtually  ending  tedious  and 
repetitive  work. 

The  Swiss  Bank  Corporation,  headquartered 
in  Basel,  Switzerland,  recently  installed  a 
sophisticated  online  system  to  reorganize  its 
daily  handling  of  thousands  of  banking  trans- 
actions. The  development  of  this  system 
required  a  massive  effort  (almost  280  man- 
years).  If  it  were  not  for  ADR's  MetaCOBOL, 
however,  these  efforts  would  have  been  in- 
calculably more  difficult.  According  to  Peter 
Aebischer,  Manager  of  Systems  Devel- 
opment, "We  have  built  up  a  library  of  145 
macros  which  has  helped  us  introduce  hun- 
dreds of  programs  in  a  very  short  time 
period.  MetaCOBOL  has  greatly  reduced 
programming  time  because  we  are  able  to 
write  a  typical  transaction  with  about  four 
pages  of  MetaCOBOL  macro  coding,  which 
is  then  automatically  expanded  to  about  40 
pages  of  COBOL  coding. 

"If  you  compare  only  the  coding  and 
verification  for  such  a  program,  it  would 
take  a  month  to  develop  it  in  normal  COBOL 
code.  It  takes  only  one  day  with 
MetaCOBOL  —  a  time  reduction  of  20  to  1." 

Similarly,  Owens-Illinois,  whose  central  DP 
headquarters  in  Toledo  serves  1 15  plants  and 
offices  throughout  the  G.S.,  reported  a 
15-20%  jump  in  programming  productivity 
by  using  MetaCOBOL  macros  as  shortcuts  to 
enter  programming  commands. 

George  Shaw,  Internal  Project  Coordinator, 
explains.  "When  O-l  took  a  serious  look  at 
programming  productivity  and  format  stan- 
dards, one  thing  we  needed  was  a  way  to 
shorten  the  process  of  coding  COBOL 
programs,  MetaCOBOL  met  that  need.  A 
programmer  can  enter  a  short,  3-line 
MetaCOBOL  macro  command,  for  example, 
and  have  it  expanded  to  50  lines  of  error-free 
COBOL  source  code  every  time.  Mow,  prac- 


tically  all  our  COBOL  programmers  use 
MetaCOBOL  facilities.  As  a  result,  produc- 
tivity has  increased  dramatically." 

"MetaCOBOL  is  a  tremendous  tool  which 
allows  us  to  get  things  done  with  less  actual 
coding,"  added  0-i's  Special  Projects  Super- 
visor, Howard  Abernathy.  "We  now  wonder 
how  we  ever  got  along  without  it." 

MetaCOBOL  facilities  are  also  used  to  raise 
the  level  of  COBOL  by  adding  the  "con- 
structs" of  structured  programming. 
Sweden's  $2.8  billion  Kooperativa  Forbundet 
(KF),  one  of  the  largest  retail  organizatiDns  in 
Europe,  implemented  this  technique  to  bring 
about  major  increases  in  productivity. 
Michael  Evans,  KF's  EDP  consultant,  com- 
ments, "One  of  our  data  processing  goals 
has  been  to  keep  the  number  of  program- 
mers constant  over  the  years,  in  spite  of 
greatly  increasing  workloads.  To  reach  this 
goal,  it  was  clear  that  we  had  to  enable  pro- 
grammers to  work  with  more  code.  When  we 
adopted  structured  programming,  we  chose 
ADR's  MetaCOBOL  as  the  tool  to  make  it 
work.  If  we  had  implemented  structured  pro- 
gramming without  using  MetaCOBOL,  the 
COBOL  code  we  produced  would  not  be  clear. 

"With  MetaCOBOL,  the  structure  is  in  the 
code.  Our  programmers  know  immediately 
what  is  happening  without  superfluous  com- 
ments. And,  when  the  programmers  main- 
tain their  programs,  they  have  automatically 
documented  the  changes  because  the  docu- 
mentation is  all  right  there  as  part  of  the 
code. 

"Today  our  programmers  have  no  doubt  that 
MetaCOBOL's  structured  programming 
language  is  the  only  way  to  write  programs. 
They  make  fewer  mistakes,  they  spend  less 
time  on  maintenance,  and  they  can  handle  a 
larger  workload." 

The  LIBRARIAM/Online  (LIB/OL)  has  brought 
the  benefits  of  online  source  program 
management  to  users  of  The  LIBRARIAh. 
LIB/OL  users  can  display  and  immediately 
update  programs  stored  on  a  LIBRARIAPS 
master  file  and  can  submit  jobs  and  review 
the  output  at  the  3270  terminal.  LIB/OL's 
scratch  pad  file  provides  a  full-screen  edit 
capability  for  efficient  program  modifications. 

Such  facilities  have  given  Colonial  Life  In- 
surance Companv  of  East  Orange.  FN. J.,  a 
number  of  time-saving  advantages.  As 
Howard  Lackow,  Vice  President  for  Data  Pro- 
cessing, says.  "In  the  first  six  months  of 
operation,  we  have  seen  a  steady  increase  in 


the  number  of  lines  of  source  code  written 
with  the  same  size  staff.  Although  we  had 
been  steadily  increasing  the  number  of  lines 
of  code  written  each  month  for  some  time, 
after  we  installed  LIB/OL  the  number  of 
lines  written  jumped  by  a  factor  of  three  in 
the  first  four  months  of  use.  We're  now 
writing  over  40,000  lines  a  month  and  still 
increasing  in  very  significant  jumps. 


"We  have  also  seen  that  LIB/OL  has  given 
our  programmers  a  lot  more  control. 
Because  a  programmer  no  longer  has  time 
lapses  between  parts  of  a  job  (as  he  had  with 
batch  operation),  he  doesn't  have  to  reorient 
himself  all  the  time  in  order  to  continue  a 
job.  He  now  concentrates  on  one  program 
until  all  the  compilation  errors  are  corrected 
and  it  is  ready  to  test.  It  has  meant  a  real  in- 
crease in  productivity  and  in  programmer 
morale.  Programmers  are  happier  now 
because  they  can  start  jobs  and  see  finished 
results  in  one  session." 

Greg  Walsh,  Assistant  Vice  President,  adds 
that,  "We  have  run  reports  when  managers 
wanted  to  see  the  bottom  line  without  get- 
ting all  the  intermediate  data.  Remote  Job 
Output  has  let  us  display  the  last  page  of  a 
report,  get  the  information  we  want  and  then 
flush  the  job  —  before  it  ever  gets  to  the 
printer.  We  found  too  that  the  Remote  Job 
Entry  portion  of  LIB/OL  is  not  restricted  to 
program  maintenance  for  our  source  code. 
With  RJE  we  can  enter  the  JCL  to  the  com- 
puter to  process  any  job.  We  use  the  scratch 
pad  area  to  assemble  the  JCL  to  run  a  com- 
plete job  stream  and  then  submit  that  as  a 
job  through  The  LIBRARIAN  facilities.  It's 
not  restricted  to  program  development  type 
work.  It's  any  remote  job  entry." 


"After  we  installs 
LIB/OL,  the  number 
program  lines  writt 
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)R's  LOOK,  ROSCOE,and 
e  LIBRARIAN  help  your 
nputer  keep  pace  with  growing 
;a  processing  requirements 


mique  real-time  measurement 
tem  essential  to  any  IBM/360  or 
0  installation  interested  in  im- 
ving  performance  of  its  MVS,  VSl, 
S,  or  MVT  environment.  LOOK  is  a 
(ible,  wide-ranging  tool  capable  of 
viding  an  immediate  and  accurate 
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emote  job  entry  system  for  OS 
'ironments  that  provides  a  conver- 
ional  approach  to  program 
paration,  testing,  and  maintenance 
remote  terminal  facilities. 
SCOE  has  a  significant  impact  in 
)gram  development  and  main- 
ence,  system  programming  ac- 
ties,  production  coordination  and 
leduling,  interactive  problem 
ving,  and  DOS-to-OS  conversions. 


"  1  he  way  LOOK  is 


briiiiant  coiijiiion. 
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:omprehensive  source  program 
:nagement  system  offering  sophis- 
^ted  data  storage  and  manipulation 
ilities  for  programming,  systems, 
J  operations  personnel  and  their 
nagers.  Along  with  its  facilities  for 
itralized  program  storage  and  pro- 
■m  security,  The  LIERARlAh  makes 
remely  efficient  use  of  data  stor- 
i  facilities;  COBOL  programs  stored 
a  LIBRARIAN  master  file  typically 
1  be  compressed  up  to  75%. 


Many  modern  DP  installations  are  plagued  by 
constant  demands  for  acquisition  of  more 
system  resources  —  more  memory,  more  disk 
storage,  even  more  CPGs  —  to  meet  the  ever- 
increasing  needs  of  their  users.  Quite  often, 
however,  these  needs  can  be  satisfied 
through  better  use  of  existing  hardware. 

LOOK  makes  more  resources  available  for 
productive  work  by  providing  instantaneous 
information  about  common  operational  con- 
flicts —  circumstances  that  quickly  degrade 
throughput  and  slow  a  production  system. 

LOOK  not  only  provides  information  on 
resource  use  and  performance,  but  also  pro- 
vides the  controls  to  dynamically  correct 
system  imbalances.  All  this  with  only  a  1% 
overhead  —  1/10  that  of  most  other  perfor- 
mance monitors. 

LOOK  is  a  system  that  is  now  keeping  hun- 
dreds of  installations  fine-tuned  and 
operating  more  efficiently. 


Rogalandsdata,  a  modern  data  processing 
center  in  Stavanger,  Norway,  found  this  to  be 
the  case  when  it  was  running  its  operation  on 
their  370/145.  Explains  Arne  Dale,  Roga- 
landsdata's  Software  Manager,  *Mt  was  a 
strange  situation!  The  system  was  com- 
pletely overloaded,  the  CPG  usage  was 
90-100%,  and  the  paging  rate  was  around 
20  pages  per  second  during  the  entire  day 
shift.  LOOK  helped  us  get  better  throughput. 

"When  we  first  considered  LOOK,  we  were 
very  skeptical  because  we  didn't  see  how  it 
could  get  such  reliable  data  using  so  little  of 
the  system's  resources.  But  we  checked 
LOOK  against  other  measurements  and 
found  that  its  data  was  accurate  within  a 
few  percent. 


"The  way  that  LOOK  is  implemented,  using 
variable  sampling  and  as  an  extension  to  the 
OS  operator  commands,  is  a  brilliant 
solution." 

Carte  Blanche  used  LOOK  to  increase  the 
efficiency  of  its  hardware  and  to  prevent  lost 
computer  time.  Kenneth  J.  Panzarella,  Infor- 
mation Services  Division  Vice  President, 
describes  their  situation.  "In  the  service 
bureau  business,  lost  time  quickly  means 
lost  revenue.  To  prevent  that,  our  operations 
group  uses  LOOK  throughout  the  day,  often 
on  a  minute-to-minute  basis,  to  see  what  is 
in  the  computer,  what  parts  are  being  used, 
and  what  jobs  are  waiting  to  be  processed. 
LOOK  lets  us  see  where  the  inefficiencies 
are  and  take  immediate  corrective  action." 

"LOOK  is  a  powerful  tool  for  many  special 
situations,  but  they  are  the  types  of  situa- 
tions that  are  with  us  on  a  day-to-day  basis. 
As  a  result,  LOOK  works  for  us  continu- 
ously," added  Software  Analyst,  Bob  Dunsire. 

Online  program  development  plays  a  major 
role  in  increasing  programmer  productivity. 
Often,  however,  the  addition  of  an  online 
system  can  create  a  need  for  expensive  hard- 
ware which  many  companies  feel  they  cannot 
afford.  ADR's  ROSCOE  combines  the  bene- 


fits of  online  conversational  programming 
with  operational  efficiency. 

Before  Allianz  Insurance  Company  installed 
ROSCOE,  for  example,  it  made  a  careful 
comparison  of  leading  terminal  systems. 
Chief  Systems  Programmer  Alexander  Metz, 
who  helped  perform  the  evaluation,  explains 
the  reasons  for  their  choice.  "Because  our 
CPG  was  already  being  utilized  80-100%  by 
teleprocessing  and  batch  jobs  and  because 
we  could  not  expand  our  hardware,  our  most 
important  criteria  for  the  choice  of  a  ter- 
minal system  were  performance  and  CPG 
load.  After  a  careful  comparison  of  leading 
systems,  we  found  ROSCOE  best.  During 
our  SVS  test  evaluation  period,  for  example, 
we  found  that  ROSCOE's  overhead  was 
under  1%  per  terminal,  while  the  other 
system  we  evaluated  required  up  to  4.5% 
per  terminal. 

"At  our  headquarters  in  Munich,  110  users 
now  have  access  to  ROSCOE  through  45 
terminals  —  for  systems  and  application 
programming,  job  preparation,  information 
retrieval,  project  planning,  monitoring,  and 
documentation.  I  don't  believe  there  is  any 
other  system  like  ROSCOE  that  can  serve 
45  terminals  with  such  good  response  time." 


"Our  most  impo: 
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Similarly,  the  Morth  Carolina  State  Highway 
Department  wanted  to  install  an  online  per- 
sonal computing  system  for  its  highway 
engineers.  Its  first  thought  was  IBM's  TSO. 
Already  shackled  with  heavy  CICS  applica- 
tions, the  addition  of  TSO  would  have  re- 
quired immediate  and  expensive  upgrading 
of  their  370/158. 

That's  when  the  Department  of  Transpor- 
tation heard  about  ROSCOE's  Time-Sharing 
Option  (RTS).  Computer  Analyst  Bob  Wells 
outlines  his  reasons  for  selecting 
ROSCOE/RTS.  "ADR  let  us  put  up 
ROSCOE/RTS  for  a  30-day  evaluation  and, 
at  the  end  of  that  time,  it  was  clear  it  would 
do  the  job  we  needed.  Some  of  the  important 
factors  in  our  decision  were: 

•  With  ROSCOE/RT§,  we  could  continue 
with  VSl  and  not  have  to  go  to  MVS. 

•  Machine  overhead  was  about  70%  less 
than  with  TSO. 

•  We  were  familiar  with  ADR  through  the 
use  of  The  LIBRARIAN  and  knew  that  if 
we  had  problems,  we  could  talk  directly  to 
the  people  who  developed  the  software." 

Conservation  of  valuable  resources  is 
characteristic  of  ADR's  software  products. 
And  conservation  in  one  area  can  have  a 
significant  impact  in  other  areas  as  well.  For 
example,  when  ADR's  The  LIBRARIAN  was  in- 
stalled at  Computer  Power  Inc.,  a  Jackson- 
ville, Florida,  mortgage  banking  computer 
service  center,  the  entire  source  program 


library  was  immediately  compressed  onto 
two  disk  packs  online  on  two  separate  drives. 
Because  it  took  full  advantage  of  common 
characteristics  among  source  languages  and 
because  it  never  allowed  random  empty 
spaces  to  accumulate,  The  LIBRARIAN 
eliminated  the  use  of  15  disk  packs. 

Today,  Computer  Power  has  switched  to  the 
IBM  3330  disk  system.  Their  entire  source 
program  library,  consisting  of  8400  program 
modules,  is  now  stored  on  a  single  online 
disk.  As  a  result,  they  are  saving  nearly  50 
hours  a  month  of  vitally  needed  computer 
time  because  they  have  no  mounts/dis- 
mounts to  perform. 


)  ^DR's  software  products  reduce 
the  cost  and  time  required  to 
maintain,  enhance,  and  convert 
programs 


It 


A  multi-purpose  COBOL-oriented 
l'|oftware  product  designed  to  assist  in 
coding,  testing,  debugging,  standard- 
izing, converting,  and  optimizing 
COBOL  programs.  Users  have  found 
that  MetaCOBOL  has  accounted  for 
a  dramatic  reduction  in  the  cost  of 
maintenance  and  enhancement  and, 
many  cases,  has  enabled  them  to 
perform  conversions  of  many  pro- 
grams more  quickly. 
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ADR's  system  for  source  program 
retrieval  and  maintenance  is  one  of 
the  computer  industry's  most  widely 
installed  products  with  over  5000  in- 
stallations worldwide.  Its  facilities  for 
■lipdating  programs  and  maintaining  a 
complete  history  of  program  changes 
have  resulted  in  major  reductions  in 
the  total  maintenance  effort. 


■I 


"MetaCOBOL  lets  us 
track  down  different 
programming  styles  and 
get  into  the  problems 
much  more  quickly." 
Mick  Kaiuger, 
Ecusta  Pauer 


"MatnCOBOL  has  been  a 
tremendous  help  in 
cleaning  up  and  .stan- 
dardizing programs  that 
were  written  over 
the  years." 
iMick  Kaluger, 
ccijsta  Paper 


Many  companies  report  that  the  large  major- 
ity of  their  programmers'  time  is  spent  main- 
taining and  enhancing  existing  applications. 
Not  only  is  time  and  effort  great,  but  com- 
panies also  are  frequently  faced  with  an 
added  problem:  individual  programmers 
whose  unique  styles  of  program  construction 
make  it  imperative  that  the  original  program- 
mer performs  maintenance. 

ADR's  MetaCOBOL  substantially  reduces 
these  problems  by  automatically  enforcing 
programming  standards  and  providing  exten- 
sive facilities  for  program  upgrading  and  op- 
timization. MetaCOBOL  makes  it  possible  for 
almost  any  programmer  to  change  and  up- 
grade anyone  else's  programs  with  a  mini- 
mum of  effort. 

Ecusta  Paper  Division  of  the  Fine  Paper  and 
Film  Group  of  Olin  in  Pisgah  Forest,  N.C.,  has 
found  MetaCOBOL  to  be  a  useful  tool  in  up- 
grading and  improving  a  large  inventory  of 
programs,  many  of  which  were  written  before 


today's  COBOL  standards  came  into  wide- 
spread use.  According  to  Nick  Kaluger, 
Manager  of  Systems  Development,  "We 
bought  ADR's  MetaCOBOL  mainly  as  a  tool 
to  clean  up  and  standardize  programs  that 
were  written  over  the  years.  These  programs 
were  assets,  just  like  our  plant  building  or 
paper-  and  cellophane-making  machinery. 
These  were  assets  that  we  thought  could  be 
salvaged.  They  were.  And  MetaCOBOL  has 
been  a  tremendous  help  in  that  effort. 

"MetaCOBOL  helps  the  programmer  get  in- 
to a  program  faster.  It  helps  us  enforce 
details  like  alignment,  paragraph  number- 
ing, level  numbering,  common  names,  etc. 


I 


.  ve  nave  more  time 
^rk  \r\  new  areas,  .  .  . 
■e  can  incroduce  ap- 
ations  which  ■A'ould 
jeen  uneconomical 
.  rew  years  ago." 
"^"eter  Aebischer, 
3  3ank  Corporation 


-nks  to  i'-letaCOBOL, 
one  can  now  easily 
;ntain  programs  or 
"J  ciianqes,  no  matter 
o  f':e  auihor  was." 
-'"^ter  /vebisc;-jer, 
.:an,:  Cor-:oration 


Gntil  recently  we  had  various  styles  of  pro- 
grams. Each  programmer  would  have  his 
own  little  pattern.  Some  would  do  repeats  at 
the  bottom,  others  would  do  them  in  the 
middle.  Some  had  little  loops,  others  had 
giant  loops.  Things  like  that  are  still  in  the 
programs,  but  we  are  now  able  to  track  down 
these  different  styles  and  get  into  the  prob- 
lems much  more  quickly." 


The  Swiss  Bank  Corporation  has  found  that 
MetaCOBOL  has  had  a  large  impact  on  main- 
taining programs  for  their  real-time  banking 
system.  As  Peter  Aebischer,  Manager  of 
Syst  ems  Development,  explains,  "Before  we 
used  MetaCOBOL  and  its  macro  facilities, 
programs  were  essentially  the  'property'  of 
the  individual  programmer  who  wrote  them. 
No  one  else  could  easily  follow  his  work.  If  a 
program  needed  maintenance,  the  original 
programmer  had  to  be  there  to  do  it.  If  he 
were  on  vacation  and  if  maintenance  were 
urgent,  another  programmer  had  to  go  into 
the  code  and  spend  perhaps  three  weeks  just 
making  a  small  addition  —  usually  finishing 
just  a  few  days  before  the  original  program- 
mer returned  anyway. 

"The  concept  of  individual  program  author- 
ship is  now  all  changed.  Thanks  to 
MetaCOBOL,  anyone  can  now  easily  main- 
tain programs  or  make  changes,  no  matter 
who  the  author  was.  Even  a  supervisor  can 
maintain  programs  when  no  one  else  is 
available  because  now  he  has  access  to  the 
needed  information  in  seconds. 

"Our  programmers  are  relieved  and  happy 
because  they  can  spend  most  of  their  time 
doing  what  they  like  to  do  best  —  writing 
new  programs,  new  applications.  And 
because  we  have  more  time  to  work  in  new 
areas,  our  costs  are  down  and  we  can  in- 
troduce applications  which  would  have  been 
uneconomical  a  few  years  ago." 


Leeds  &  Northrup  Corporation,  a  major 
manufacturer  of  process  control  instrumenta- 
tion, found  that  MetaCOBOL  played  a  key 
part  when  they  converted  and  upgraded  more 
than  1500  programs.  In  planning  for  the  OS 
system  which  is  now  installed,  Leeds  & 
Morthrup  was  required  to  convert  from  DOS 
ANS  COBOL  to  OS  ANS  COBOL.  MetaCOBOL 
was  the  tool  that  made  this  possible. 


MetaCOBOL  was  installed  and  80%  of  the 
conversion  to  OS  ANS  was  completed  in  less 
than  three  months. 

According  to  Joe  Dupon,  Manager  of  Com- 
puter Technology,  "We  figured  with 
MetaCOBOL  that  maybe  10%  of  the  pro- 
grams would  have  to  have  some  manual  in- 
tervention in  the  code  conversion.  We  were 
happily  surprised  to  find  out  that  we  had  to 
touch  less  than  1%.  We  reached  a  point  in 
the  conversion  cycle  when  we  took  DOS  pro- 
grams, fed  them  into  MetaCOBOL,  and  took 
them  through  the  compiler,  link-edited 
them,  and  had  them  ready  to  go.  All  we  had 
to  do  then  was  create  the  conversion  JCL." 

ADR's  The  LIBRARIAN  was  initially  installed 
four  years  ago  at  Pepsi-Cola  to  simplify  and 
control  program  update  procedures.  It  is  now 
a  fundamental  tool  used  to  maintain  central 
control  over  the  use  and  modification  of  all 
programs.  Its  facilities  for  source  program 
maintenance,  control,  and  security  have 
made  strict  accountability  an  almost  auto- 
matic daily  process. 

Over  200,000  man-hours  are  invested  each 
year  in  software  system  development, 
documentation,  management,  and  use. 
Pepsi-Cola  looks  upon  its  program  library  as 
an  important  asset  to  be  protected  and  made 
more  efficient  in  every  possible  way.  And 
software  products  from  Applied  Data 
Research  are  an  important  part  of  that  effort. 
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software  products  provide 
means  to  generate  and  update 
ual  information,  system 
cifications,  and  program 
jmentation 


nline  word-processing  tool 
h  utilizes  computer  rescHjrces  to 
Tiate  the  preparation,  and 
tenance  of  any  textual  material, 
loped  in  response  to  the  many 
comings  of  most  manual  (and 
the  more  sophisticated  word- 
2ssing)  approaches  to  document 
jction,  ETC's  automated  facil- 
expedite  even  the  most  tedious 
ents  of  document  preparation  — 
ing,  editing,  final  typing,  and 
ing. 


mary  system  documentation  tool 
reating  and  maintaining  diverse 
5  of  system-  and  application-level 
mation.  The  various  high-level 
:s  and  reports  automatically  pro- 
d  by  ASC  create  a  reliable  and 
isive  network  of  information  for 
ing  systems,  as  well  as  new 
■ms  under  development. 


"Before  ETC,  it  took 
forever  to  get  a  manual 

redone.  Now  new  up- 
dates appear  in  a  matter 
of  days."  Reg  Campbell, 
Hibernla  national  Bank 
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dvanced  system  development 
which  analyzes  source  module 
'  and  automatically  produces 
isive  cross-referenced  listings, 
lie  charts,  and  detailed  sum- 
3S  of  individual  program  activity, 
management  tool,  AUTOFLOW  II 
".s  in  creating  and  sustaining  a 
oiled  and  organized  installation 
onment:  as  a  programming  tool, 
3FL0W  II  helps  in  developing 
naintaining  accurate  and  reliable 
cations. 


"At  Owens-iillnoi-^,  15 
procedures  manuais 
<:ontainir!<5  about  10,000 
pages  are  maintained 
through  ETC  by  a 
'iinqlc  clerk," 
George  Shaw. 
Owens-Illinois 


In  today's  competitive  corporate  envi- 
ronments, good  documentation  is  essential 
to  an  efficient  operation  —  not  only  docu- 
mentation for  use  within  the  data  processing 
environment,  but  also  manuals  and  direc- 
tories used  throughout  an  organization.  Pro- 
ducing and  updating  such  documents, 
however,  often  strain  an  organization's 
resources  to  the  point  that  needed  documen- 
tation is  either  not  produced  or,  at  best,  is 
badly  out-of-date. 

Recognizing  these  problems.  ADR  has  de- 
veloped tools  to  harness  the  computer  to 
generate  and  maintain  documentation  in  a 
fraction  of  the  time  normally  required  by 
manual  methods. 

ADR's  On-line  ETC  (Extended  Text  Compos- 
itor) is  a  word-processing  system  designed  to 
facilitate  the  production  of  a  wide  range  of 
textual  material  —  from  highly  technical 
reference  manuals  to  telephone  directories, 
form  letters,  and  memoranda.  ETC  enables 
terminal  operators  with  minimal  training  to 
economically  generate  and  maintain  thou- 
sands of  pages  of  material. 

Mew  Orleans'  Hibernia  [National  Bank  has 
found  that  ETC  not  only  reduces  the  time  and 
effort  they  spend  to  produce  a  manual,  but 
also  allows  them  to  keep  manuals  up-to-date 
and  to  improve  communications  within  their 
branches  as  well.  Reg  Campbell,  Systems  and 
Programming  Manager,  comments  that, 
"Our  manuals  are  used  by  personnel 
throughout  our  entire  banking  system. 
Anyone  who  prepares  any  type  of  data  for  in- 
put to  the  computer  is  guided  by  one  or 
more  of  our  procedures  manuals. 

"Since  our  personnel  heard  about  our  use  of 
ETC  and  how  easily  changes  are  made,  they 
are  no  longer  hesitant  to  suggest  improve- 
ments or  modifications  to  procedures. 
Before  ETC,  it  took  forever  to  get  a  manual 
redone.  Now,  however,  their  suggestions  are 
likely  to  appear  in  a  new  update  in  a  matter 
of  days.  ETC  has  really  helped  to  improve 
communication  with  the  people  who  have  to 
use  our  manuals  in  their  day-to-day  work. 

"A  tool  as  powerful  and  flexible  as  ETC 
impressed  me  because  1  could  train  some- 
body so  easily.  When  new  secretaries  come 
into  the  department,  they  practice  with  the 
terminal  and  it  becomes  a  challenge.  They 
really  like  it." 

"At  Owens-Illinois,  15  procedures  manuals 
containing  about  10,000  pages  are  main- 
tained through  ETC  by  a  single  clerk,"  ex- 


plains  Internal  Coordinator  George  Shaw. 
"But  only  about  a  third  of  her  time  is  spent 
in  keeping  up  with  all  the  changes  to  our  pro- 
cedures manuals.  ETC  lets  us  create  a  per- 
fectly formatted  document  without  having 
to  go  to  a  typist.  Now,  our  typists  are 
primarily  concerned  with  short  admin- 
istrative letters  since  all  documentation  is 
handled  by  ETC. 


"With  ETC,  we  can  change  a  page  here  and  a 
section  there  and  get  the  updated  informa- 
tion to  the  right  people  without  having  to 
redo  the  entire  manual  —  and  it's  inexpen- 
sive. ETC  is  a  powerful  piece  of  software. 
And  when  you  consider  the  cost  of  copying 
and  the  cost  of  delays  that  come  with  hand- 
typing,  it  becomes  a  tremendously  worth- 
while package." 

ADR's  Automated  System  Charter  (ASC)  is  a 
dynamic  remedy  for  the  pressing  need  for  ef- 
fective system  documentation.  It  permits  the 
user  to  easilv  obtain  the  critically  needed  in- 


formation which  is  essential  to  a  disciplined 
and  productive  approach  to  system  main- 
tenance and  enhancement.  The  high-level 
system  charts  and  reports  automatically  pro- 
duced by  ASC  create  a  reliable  and  extensive 
information  network. 

Mobil  Oil's  rSew  York  DP  headquarters  uses 
ASC  to  keep  up  with  changes  to  over  300 
systems,  a  third  of  which  may  be  extensively 
changed  in  any  year.  Maintaining  up-to-date 
standardized  documentation  in  this  environ- 
ment by  manual  methods  would  be  quite  im- 
possible. According  to  Jean-Louis  Legrand, 
Mobil's  Client  Services  Supervisor,  "Before 
ASC,  there  was  no  standard  way  of  pre- 
senting system  charts.  Some  programmers 
would  use  squares  and  others  would  use 
circles  to  describe  the  same  type  of  step. 
Some  charts  were  very  detailed,  and  some 
were  not  detailed  at  all.  Each  chart  ended  up 
reflecting  many  individual  styles  and  pref- 
erences. Now  the  results  are  more  uniform 
and  complete,  and  it  is  much  easier  for  any 
of  our  programmers  or  Client  Coordinators 
to  quickly  understand  a  system. 

"It  is  difficult  to  estimate  costs  when  you 
are  dealing  with  people's  time,  especially 
programmers  writing  documentation.  But, 
by  our  most  reasonable  estimates,  we  found 
that  ASC  has  enabled  us  to  document  a 
system  in  about  half  the  man-hours  that  we 
would  have  normally  used." 

ADR's  AGTOFLOW  II  and  Cross-Program 
Auditor  (CPA)  help  create  and  maintain  the 
disciplined,  well-structured  programming 
environment  essential  to  the  effective 
management  of  program  development  and 
maintenance. 

AUTOFLOW  II  accepts  and  analyzes  over  20 
source  languages  to  produce  extensive  cross- 
reference  listings,  summaries,  and  graphic 
charts  of  various  aspects  of  program  or 
module  activity  and  logic. 

AGTOFLOW  ll's  predecessor,  AGTOFLOW,  is 
one  of  the  first  software  programs  ever  to  be 
granted  a  G.S.  patent.  AGTOFLOW  II  today 
represents  nearly  ten  years  of  software  design 
and  experience  focused  on  increasing  effi- 
ciency, economy,  and  effectiveness  in  pro- 
gramming operations  worldwide. 

CPA,  available  under  AGTOFLOW  II  or 
The  LIBRARIAM,  examines  and  reports  upon 
characteristics  of  an  entire  system  of  COBOL 
programs,  across  individual  program  bound- 
aries, within  the  context  of  their  functional 
interaction. 
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An  important  ooint  about  ADR's  softv/are  orcducto  — 
RCSCOE,  The  LIBRARIAiN,  and  ;^\et3CC30L  — 
13  that  they  nave  always  v/orked  to  jpeci;':cation3. 

"The  program  packages  that  have  j:een  3hlopea  to  us 
have  had  a  virtual  zero  ciefect  l2vel. 
.\s  a  result,  v/e  nave  iiever  iiesitateci  :o  put  ..'.ern  to 
■.vork  in  our  system  without  the  i?^;igthy 
trial  and  test  procedures  that  .ve  normaily  v.se 
with  our  other  products." 
Joe  DuDon.  Leeds  &  r-iorthruo 


"Our  experience  with  VOLLIZ  lias  jeen  indicative 
of  the  actituue  ADR  has  tor  ics  pA^nduct. 
Thev  cion't  :;ven  'vani:  to  -eno  vi  .lyicsiT:  :.:^eir 
beta  test  sites  unle.ss  ti;e'-'  nr'*. 
pretty  .vel!  "acisfieu  r\^~r.. 
John  Gregory,  I loilyv-'oou  "e-jersn 


"At  .  iopaian '^i'in ;. a.  - /e  nr  e  i":ovv";;rii '.le-i  L'5  "vrovidinq 

'V-  consider     .lurnrjr       r-icior:;   vn.:;,:  clng 
■vhich  ':o;tv'rire  TOriurt-;  ■:.■]'.]  he  ir::;t;:!i^e'J 
>r  'pin';r,;!  use:  veri  orm;"!ii'7':.  ;    ! : '.:ci !i  tv,  '";rf i incv,  "nci 
-ja  t  •  h  ii  i  *■  •'  •        v-ir-'!  iire'"::y  .n 

;       .  .c ora i.: i,<.: n r  a    n  c!  '  ,"; e  c:  oath ;  i  -  ;.'.;e!'ri 
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INSTALLATION  AND 
TRAINING 

ADR's  products  are  installed 
throughout  the  world  by  ADR- 
trained  technicians.  These  Tech- 
nical Support  Representatives 
also  train  users  thoroughly  in  the 
use  of  the  products.  ADR's  sys- 
tematic approach  to  installation 
and  training  ensures  a  smooth 
transition,  for  both  operations 
personnel  and  users,  between 
current  practices  and  the  new 
environment. 

PRODUCTS  DELIVERED 
READY  TO  WORK 

When  an  ADR  product  is  in- 
stalled, the  user  can  be  sure  that 
it  will  work  to  specification. 
Every  ADR  product  or  product 
enhancement  undergoes  thor- 
ough alpha  and  beta  testing  to 
assure  near-perfect  product 
reliability.  Only  then  is  a  product 
released  to  the  user  community. 

DOCUMENTATION 

ADR's  products  are  fully 
documented  in  manuals  which 
provide  all  the  information 
necessary  for  efficient  instal- 
lation and  effective  use.  ADR 
supports  a  'common  sense'  ap- 
proach to  technical  docu- 
mentation, in  which  information 
is  presented  in  simple,  direct 
language  and  supported  liberally 
with  tables,  exhibits,  and  exam- 
ples. All  documentation  is 
thoroughly  edited  and  field- 
tested  and  is  constantly  reviewed 
by  both  the  editorial  and  product 
development  staffs.  This  con- 


tinual  effort  ensures  that  readers 
at  every  level  will  be  able  to 
achieve  a  clear  and  complete 
understanding  of  the  operation 
and  capabilities  of  the  product. 

SGPPORT 

ADR's  Technical  Support  Rep- 
resentatives are  available  for  on- 
site  assistance  when  needed. 
ADR's  representatives  are  highly 
trained  specialists  capable  of 
providing  expert  help  for  the  full 
range  of  ADR's  products  in  all 
operating  environments.  Real- 
izing the  critical  nature  of  com- 
puter operations  throughout  the 
world,  ADR's  representatives  or 
product  specialists  are  available 
by  telephone  or  telex  whenever 
an  emergency  arises. 

USER  GROOP  MEETINGS 

Users  of  ADR's  software  products 
meet  both  nationally  and  inter- 
nationally to  exchange  problem- 
solving  ideas,  techniques,  and 
experiences  and  to  learn  of 
enhancements  planned  for  the 
product.  Published  proceedings 
are  distributed  to  further  en- 
courage effective  and  new  uses 
of  the  products. 

WORLDWIDE  OFFICES 

ADR  is  the  only  software  com- 
pany with  offices  throughout  the 
United  States  and  represen- 
tatives in  more  than  40  cities 
throughout  the  rest  of  the  world. 
Each  office  is  staffed  with  ADR- 
trained  specialists  ready  to  serve 
your  needs. 


"^yc  brought  in  a  software  prodajct  from  another 
company.  When  v/e  triad  to  install  it, 
'■ye  found  problems  -vitn  it  and  ended  up  performing 

debugging  for  the  vendor.  Tieediess  to  say, 
v/e  couldn't  use  the  product  on  that  basis  and  sent 
it  back.  That  has  never  happened  to  us 
with  ADR  products.  V/e've  found  chem  to  be  ready  to 

use  as  shipped,  and  they're  installed 
quite  easily.  And  we've  had  technical  assistance  i'rom 
,\DR  technicians  'vhen  we  needed  it." 
Gary  Mall,  Ohio  /-ledicai  Indemnity 


"The  ADR  ROSCOH  User  Grouo  is  one  of 
many  ROSCOE  benefits.  I  went  to  my  first  ROSCOE 

User  Group  m.eeting  and  came  bac'r.  v.'ith 
new  ideas  and  names  of  peopie  at  otner  companies 
who  had  done  excit-ng  things  with  2OSQ0z. 

Because  i  got  so  mucn  out  of 
my  first  meeting,  I  intend  to  30  to  every  one 
so  thai;  I  can  coniinue  to  exchange  ideas 
a.id  find  new  problem  solutions." 
Bob  Dunsire,  Carte  Blanche 


"Wisenever  we  have  broi-^jht  io  a  c.ew  release  ot  Li3/GL, 
^ve've  been  so  conrident  that  we  have  iust 
loaded  it  riynt  on  Loo  iii  me.  old  one.  We  do  a  daiiv 
bac'.up  o;  :.:G:,jr:3e.  but  ..v.  Jon't  !:ave  10  Jo  zay  Ihotviigh 
te;:ting,  ".Ve  y.Asi  Uirow  a  :^ew  reiea.-;e  out 
there,  .ind  it  yenerallv  ^vor^is  witliout  difficulty. 
li  -ve  -io  have  av-'   ;';e;:tions.  we  ;u;-t  call 
tlie  ADx  sur^nort  ^,vv'j.  T'lev  ve  been  vorv  hei'^n?!. 
V-i  iay..:iri;  had  .Mi  '?ron^em:s  ii!," 
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Applied  Data  Research's  com- 
puter software  products  are 
regarded  by  their  users  as 
Number  1  in  the  industry  ac- 
cording to  the  results  of  the  re- 
cent 1977  Datapro  survey  of 
users  of  software  products.  ADR 
won  more  honors  than  any  other 
firm,  receiving  top-rated  Honor 
Roll  awards  for  The  LIBRARIAN, 
LOOK,  ROSCOE,  and  an  honor- 
able mention  for  MetaCOBOL. 
The  survey  was  based  on  ques- 
tionnaires sent  to  more  than 
30,000  data  processing  ex- 
ecutives. With  more  than  5800 
respondents  commenting  on 
1223  different  packages,  only  44 
packages  received  Honor  Roil  or 
honorable  mention  status  for 
overall  user  satisfaction. 

Award-winning  recognition  is 
nothing  new  to  ADR.  Its  products 
have  been  cited  every  year  in  the 
Datapro  survey,  with  a  total  of  1 1 
commendations  in  the  5-year 
history  of  the  awards. 

Overall  user  satisfaction  with 
ADR  products  has  been  rated  in 
another  important  way,  too  — 
overall  product  sales.  Five  of 
ADR's  products  have  been  the 
recipients  of  the  ICP  Million 
Dollar  Awards:  The  LIBRARIAN  — 
20  Million  Dollar,  ROSCOE  and 
AGTOFLOW  11—10  Million 
Dollar,  MetaCOBOL  —  5  Million 
Dollar,  and  LOOK  —  1  Million 
Dollar  Awards. 


INTERACT 


Introduction 


INTERACT  is  an  online  system  that  offers  an  efficient  way  of  handling  text  entry,  text  manipula- 
tion, and  remote  job  processing.  INTERACT  is  conversational  and  terminal-oriented.  It  affords 
high  performance  standards,  reliability,  and  considerable  cost  savings. 

With  INTERACT,  data  such  as  text  documents,  programs,  or  JCL  are  readily  available  on  a  current 
basis  for  either  examination  or  change.  Remote  terminals  connected  to  a  central  computer  through 
INTERACT  allow  users  ready  access  to  their  information  base.  In  addition,  users  may  submit  jobs 
to  the  central  computer's  job  queue  from  a  remote  terminal  and  retrieve  job  output  at  that  location. 

INTERACT  provides  the  following  facilities: 

m  Text  entry  and  editing.  Text  can  be  entered  from  a  terminal  or  through  con- 
ventional batch  methods.  Once  entered,  data  can  be  manipulated  by  means 
of  INTERACT  commands.  When  modifications  are  made,  INTERACT 
displays  the  revised  text  as  the  changes  are  applied. 

□  External  storage.  Text  can  be  saved  on  disk  and  instantaneously  retrieved  at 
the  terminal  for  examination  or  updating. 

a  Remote  job  processing.  Jobs  can  be  submitted  and  monitored  from  a  remote 
terminal.  Job  output  can  be  directed  to  the  terminal  and  portions  can  be 
printed  or  discarded  as  required. 

a  Text  and  letter  processing.  Using  INTERACT's  AUTOFORM  facility,  text 
can  be  formatted  into  camera-ready  copy  of  documents,  letters  or  manuals. 
In  conjunction  with  the  letter  writer,  labels  lean  be  generated  for  complete 
automation  of  mailings. 

a  Interactive  programming.  INTERACT  commands  in  combination  with  the 
INTERACT  preprocessor  act  as  a  powerful  high-level  programming 
language.  The  Execute  Command  Language  can  be  used  to  perform 
arithmetic  and  logical  computations  as  well  as  many  of  the  other  functions 
associated  with  a  programming  language. 

a  Accounting  facilities.  INTERACT  generates  records  after  each  session  that 
provide  statistical  information  regarding  that  session  for  the  System  Manage- 
ment Facilities  (SMF)  data  set.  These  records  can  be  used  to  produce 
INTERACT  reports  that  detail  individual  and  group  statistics  and  changes. 
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The  User  and  IMTERACT 


Communications  at  the  terminal  are  user-oriented  and  conversational.  INTERACT  communicates 
with  the  user  during  the  entire  terminal  session,  responding  to  requests  from  the  user  and  asking 
questions  if  more  information  is  needed.  The  commands  are  easy  to  learn  because  they  have  an 
English-like  structure.  INTERACT  commands  have  short  forms  (abbreviations)  that  make  it  easier 
for  the  non-typist  to  use. 

While  signed  on,  each  user  has  a  one-to-one  relationship  with  the  central  computer.  It  appears  as  if 
there  is  only  one  user  on  the  system.  Practically  everything  the  user  asks  INTERACT  to  do  is  done 
independently  from  any  other  processing  that  may  be  occurring  within  the  system.  A  user  may  sub- 
mit jobs,  send  documents  to  a  high-speed  printer,  and  begin  revisions  on  another  document  —  with 
each  task  executing  concurrently. 

In  the  event  of  a  system  or  a  communication  line  failure,  INTERACT  provides  full  recovery;  no 
data  is  lost,  so  time-consuming  re-entry  is  eliminated.  Recovery  is  performed  automatically  and  in- 
stantly; as  soon  as  the  INTERACT  system  is  restarted  after  an  operating  system  failure  or  as  soon  as 
a  user  signs  on  again  after  a  communication  line  failure. 


2 


INTERACT  Computliig  Applications 


Program  Development.  INTERACT  is  ideal  for  programmers.  INTERACT  increases  the  number  of 
turnarounds  available  on  a  daily  basis  as  well  as  decreasing  the  time  between  turnarounds.  IN- 
TERACT gives  the  programmers  visibility  and  control  of  their  own  jobs.  This  not  only  increases 
productivity  but  it  greatly  increases  job  satisfaction.  Because  tasks  can  be  completed  sooner,  pro- 
grammers have  the  option  of  working  on  fewer  tasks  simultaneously,  thus  reducing  the  amount  of 
time  wasted  switching  from  one  task  to  another. 

In  addition  to  better  turnaround,  the  power  of  INTERACT  commands  reduces  the  amount  of  key- 
ing required  to  perform  program  maintenance.  By  using  the  execute  facility,  programmers  can  ac- 
complish some  tasks  in  minutes  that  would  otherwise  require  days  or  weeks.  For  example,  an  ex- 
ecute program  can  be  created  to  search  an  entire  library  for  all  occurrences  of  the  word  '3330'  and 
list  them'or  change  them  to  '3350'.  This  capability  makes  INTERACT  an  excellent  conversion  tool. 

Timesharing.  INTERACT's  English-like  command  structure  and  the  Execute  Command  Language 
make  it  excellent  for  non-programmers.  These  users  receive  all  of  the  benefits  of  INTERACT's  fast 
turnaround  and,  at  the  same  time,  are  not  subjected  to  the  problems  JCL  causes  them.  Once  a  set  of 
execute  programs  has  been  created  for  a  specific  set  of  users,  such  as  an  engineering  group,  all  their 
work  can  be  done  completely  without  reference  to  JCL  or  other  computer-oriented  problems.  This 
gives  users  direct  control  over  their  work,  significantly  reducing  the  amount  of  support  necessary 
from  the  data  processing  group. 

Word  Processing.  INTERACT  excels  in  high  volume  word  processing  applications  such  as  letter 
writing,  label  generation,  and  the  preparation  of  large  documents.  The  ability  to  directly  access 
computer  files  adds  a  new  dimension  to  word  processing.  With  its  ability  to  prompt  for  information, 
AUTOFORM  extends  word  processing  to  untrained  word  processing  operators.  Prompting  also 
reduces  errors  and  makes  it  easy  to  perform  applications  which  are  not  frequently  performed  and 
therefore  may  not  be  remembered  from  one  use  to  the  next. 

Production  Control  and  Scheduling.  Reruns  due  to  improper  input  are  a  continual  problem  in  most 
production  control  groups.  The  ability  to  edit  responses  given  by  the  operator  makes  the  Execute 
Command  Language  ideal  for  entry  of  data  which  must  be  correct.  In  addition,  online  files  such  as 
the  master  schedule  file  may  be  accessed  for  additional  editing.  Execute  programs  can  be  written  by 
the  control  group  —  programming  experience  is  not  necessary.  In  fact,  many  INTERACT  installa- 
tions have  automated  their  production  scheduling,  resulting  in  substantial  personnel  savings  as  well 
as  a  reduction  in  errors. 


3 


iNTEHACT  Facilities 


Text  Entry  and  Editing.  Text  entry  operations  include  automatic  prompting  and  line  numbering, 
tabbing,  simple  backspace  corrections  or  discarding  of  entire  lines.  Powerful  text-editing  operations 
allow  deleting,  inserting,  and  replacing  single  characters,  character  strings,  single  lines,  or  line 
ranges.  Lines  may  be  moved  or  copied  without  renumbering  the  entire  document.  Ranges  may  be 
defined  by  line  number,  column  number,  string  occurrence  or  the  absence  of  a  string.  Lines  may  be 
referenced  by  symbols  (FIRST,  LAST,  etc.).  Line  number  design  is  decimal,  which  allows  insertions 
of  up  to  999  text  lines  between  2  existing  lines.  Full  screen  management  permits  fast  review  and 
modification  of  entire  screens  for  3270-compatible  terminals. 

Data  Set  and  Catalog  Management.  Text  may  be  saved  permanently  on  disk  as  sequential  data  sets 
or  partition  data  set  (PDS)  members.  Input  and  output  records  are  variable  length  up  to  133 
characters.  The  data  sets  may  be  saved,  retrieved,  cataloged,  recataloged,  uncataloged,  or  scratch- 
ed. PDS  libraries  may  be  compressed  automatically  to  save  space  and  access  time.  Directories  and 
VTOCs  may  be  examined  for  private  as  well  as  public  libraries.  Library  access  is  security  protected 
on  several  levels,  and  data  set  integrity  is  maintained  during  updates. 

Remote  Job  Processing.  Job  streams  may  be  prepared  and  submitted  from  a  terminal.  The  user  may 
inquire  about  the  status  of  any  job  in  the  system  using  INTERACT  commands.  HASP/JES  com- 
mands are  supported  for  print,  route,  purge,  hold,  release,  cancel,  and  alter  functions.  The  output 
of  any  job  on  the  system  spool  files  may  be  retrieved  at  the  terminal;  no  special  JCL  is  required 
when  submitting  the  jobs.  Output  may  be  retrieved  as  many  times  as  desired.  Output  is  available  un- 
til the  user  instructs  INTERACT  either  to  purge  it  or  to  print  it  at  a  central  or  a  remote  location. 
When  job  output  is  retrieved  at  a  terminal,  it  is  numbered  automatically,  and  all  of  the  text  editing 
commands  may  be  used  to  examine  the  output.  Access  to  jobs,  like  access  to  data  sets,  is  also  securi- 
ty protected. 

Word  Processing.  Text  may  be  formatted  easily  by  the  document  processing  feature  of  IN- 
TERACT. Facilities  include  automatic  alignment  and  justification,  centering,  indenting,  page  com- 
position and  numbering,  underlining,  and  headings  and  footings.  INTERACT  will  even  compose  a 
table  of  contents  and  automatically  generate  the  proper  page  references  if  requested.  Special 
characters  (such  as  superscripts  and  subscripts)  may  be  included  in  offline  listings.  Form  letters  with 
variable  text  insertion  are  also  handled.  Formatting  and  reformatting  of  text  is  performed  easily  any 
number  of  times.  Powerful  list  options  allow  the  user  to  control  spacing  and  skipping  and  to  print 
multiple  copies  of  documents  with  or  without  Une  numbers. 
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The  Execute  File  Facility  and  the  INTERACT  Preprocessor.  Using  the  execute  facility,  a  sequence 
of  INTERACT  commands  that  perform  a  specific  function  may  be  executed  by  a  single  command. 
In  addition,  a  subset  of  INTERACT  commands  coupled  with  the  execute  facility  and  the  IN- 
TERACT preprocessor  form  a  powerful  programming  language.  Features  provided  include: 
variables,  expression  computation,  assignment  statements,  data  attributes,  branching  statements, 
and  predefined  functions  for  both  numeric  and  character  string  processing.  Data  that  may  be 
manipulated  include  INTERACT  commands,  JCL,  source  code,  input  data,  or  any  combination 
thereof.  Any  of  these  statements  may  contain  variable  symbols  to  signal  points  of  parameter 
substitution.  The  INTERACT  preprocessor  will  enter  values  in  place  of  these  points  of  substitution 
during  execution.  The  values  may  be  set  by  the  user,  or  received  as  input  from  the  terminal,  and 
comments  may  be  displayed  at  the  terminal. 
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Cost  Effectiveness 


INTERACT  has  a  total  system  approach  that  is  simply  unmatched.  It  offers  an  efficient  means  of 
dealing  with  text  entry,  text  editing,  and  remote  job  processing.  Significant  operating  efficiency  and 
economy  is  provided  in  a  number  of  ways: 

Q  Broad  Application  Range.  INTERACT  provides  computer  services  to  many 
different  types  of  users  when  they  need  it.  Application  programmers  can  sub- 
mit jobs  and  retrieve  output  onHne  at  remote  terminals  without  the  delays  of 
batch  processing.  System  programmers  can  perform  operating  system  ac- 
tivities, display  operating  system  information,  and  issue  privileged  HASP/ 
JES  commands  from  a  remote  terminal.  Typists  have  a  full  range  of  text 
editing  commands  for  their  use  in  creating  and  modifying  text  documents, 
which  helps  eliminate  keyboard  errors  and  increase  revision  speed.  Users 
may  have  documents  printed  at  a  typewriter  terminal  or  on  a  high-speed 
printer  whenever  copies  are  needed. 

□  Improved  Turnaround.  INTERACT's  remote  processing  ability  eliminates 
many  of  the  problems  associated  with  batch  runs.  No  more  waiting  on 
printer  backlogs  —  job  output  can  be  retrieved  at  a  terminal  to  determine 
whether  the  job  has  run  successfully.  For  the  programmer,  this  means  less 
time  spent  waiting  for  resources,  more  time  spent  doing  productive  work. 

a  Increased  Productivity.  INTERACT  provides  a  time-saving  approach  to  text 
creation  and  manipulation,  whether  it  be  for  programming  activities  or 
document  processing.  Users  can  make  extensive  changes  quickly,  using 
facilities  that  permit  global  modifications  throughout  an  entire  file  or  several 
files.  Tedious  and  time-consuming  editing  can  be  performed  quickly  and  ef- 
fortlessly, thus  freeing  users  for  more  important  tasks.  INTERACT  helps 
relieve  some  of  the  load  on  computer  operators.  There  are  fewer  card  decks 
to  read  and  punch  and  fewer  printouts  to  be  sorted  and  delivered  when  IN- 
TERACT's remote  processing  facilities  are  used. 


a  System  Efficiency.  INTERACT  approximates  block  locations  when  search- 
ing files  and  reads  and  writes  only  what  is  necessary  instead  of  processing  the 
entire  file.  This  provides  significant  access  time  reductions.  INTERACT  also 
uses  an  internal  blank  suppression  technique  to  remove  extra  blank 
characters  when  storing  data  sets  on  disk,  thus  cutting  down  on  disk  space  re- 
quirements. The  blanks  are  not  lost  —  INTERACT  remembers  where  to  put 
them  when  the  files  are  retrieved. 
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a  Minimum  Operating  Considerations.  INTERACT  is  available  over  a  full 
range  of  operating  systems:  OS/MFT  and  MVT,  VSl,  and  VS2  (SVS/MVS). 
Upgrading  to  another  operating  system  or  machine  requires  no  database  con- 
version or  re-entry.  INTERACT  does  not  disrupt  current  system  configura- 
tions or  operating  schedules.  It  may  be  run  alongside  batch  processing  and 
other  online  systems.  INTERACT  supports  standard  terminals:  local  and 
remote  3270s,  2741s,  TTYs,  or  equivalent  types. 

B  Comprehensive  Accounting  Facilities.  Accurate  accounting  information  is 
automatically  generated  for  the  SMF  data  set  and  for  INTERACT-generated 
reports.  An  installation  may  choose  to  use  standard  SMF  accounting  pro- 
grams or  write  its  own.  Accounting  information  is  gathered  for  disk,  page, 
card,  and  line  counts;  CPU  time;  elapsed  time;  run  times;  etc. 

INTERACT  can  enhance  the  total  productivity  of  an  installation  while  providing  substantial  sav- 
ings, including  reduced  paper  and  card  costs  and  fewer  new  equipment  requirements. 
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Text  Entry  and  Editini 


The  user  signs  on  the  INTERACT  system  and  is  assigned  a  work  space  (file)  for  holding  text  to  be 
created  or  manipulated.  An  active  file  can  also  be  used  to  hold  input  and  output  when  running  jobs 
remotely.  All  of  the  text  editing  commands  will  work  on  an  active  file.  Using  line  numbers  assigned 
by  the  system,  the  user  may  issue  any  of  the  following  commands  to  manipulate  text: 

COLLECT      Save  and  number  text  in  an  active  file 


LIST 
POINT 


Display  all  or  part  of  an  active  file  online  or  print  it  offline 


PUNCH 

CHANGE 

EDIT 

MODIFY 


Punch  all  or  part  of  an  active  file  to  cards 

Insert,  replace,  or  delete  single  characters  or  character  strings  in 
specific  columns,  in  single  lines  or  line  ranges,  or  in  an  entire  file 


INSERT 


Insert  lines  of  text  between  existing  lines 


REPLACE  Replace  existing  Hnes  of  text  with  new  text  lines 
DELETE        Erase  entire  lines  of  text 


COPY 
MOVE 


Copy  lines  from  within  an  active  file  or  from  an  external  file  to  a 
location  within  an  active  file 


COMPARE     Compare  the  text  in  two  sets  of  consecutive  lines,  existing  in  one  of 
more  active  files,  line  by  line 

NUMBER       Renumber  all  or  part  of  an  active  file 

CLEAR  Erase  an  active  or  execute  file,  the  tab  settings,  or  the  data  set  name 

fields 


LOGON  Establish  or  terminate  terminal  sessions  on  INTERACT 
LOGOFF 
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SPECIAL  EDITING  FEATURES 

Full  Screen  Management.  This  feature  allows  a  user  working  at  a  3270  terminal  to  enter  an  entire 
screen  of  data  into  an  active  file  with  a  single  depression  of  the  enter  key.  The  ability  to  manipulate 
full  screens  of  data  at  once  makes  text  editing  faster  and  greatly  reduces  I/O  processing. 

Multiple  Active  Files.  This  permits  more  than  one  file  to  be  edited  simultaneously.  This  is  useful  in 
those  situations  where  the  user  wants  to  make  changes  in  one  file  while  looking  at  another  file. 
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Data  Set  and  Catalog  ^lanagement 


When  the  task  of  entering  text  into  an  active  file  has  been  completed,  a  user  may  save  a  copy  of  the 
text  on  disk  as  an  external  file.  Once  saved,  it  may  be  brought  back  into  an  active  file  any  number  of 
times  for  examination  or  change.  The  commands  used  to  create,  access,  and  manage  data  sets  as  ex- 
ternal files  are: 


SAVE 

USE 
COPY 


Copy  all  or  part  of  an  active  file  onto  external  file  space 

Read  an  external  file  or  any  online  sequential  disk  data  set  or  PDS 
member  into  an  active  file 


SCRATCH     Scratch  a  specified  external  file 

CATLG         Catalog,  recatalog,  or  uncatalog  data  sets  on  the  system  catalog 

RECATLG 

UNCATLG 

CONDENSE   Submit  a  job  that  will  compress  a  specified  PDS 

GIVE  Allow  one  group  member  to  give  INTERACT  disk  space  to  another 

group  member 

PROTECT  Associates  a  password  with  a  data  set  so  that  anyone  using  the  data 
set  must  specify  the  password  in  order  to  access  it.  Once  created, 
passwords  may  be  deleted  or  changed. 
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Remote  Job  Procassing 


A  user  at  a  remote  terminal  may  run  any  job  that  can  be  processed  in  the  conventional  batch  pro- 
cessing mode.  A  user  may  also  check  the  status  of  any  job  in  the  central  computer's  job  stream.  The 
following  set  of  commands  are  used  to  interface  with  the  operating  system  in  performing  these 
functions: 

RUN  Submit  all  or  part  of  an  active  file  into  the  job  input  stream  of  the 

central  computer 

LOCATE  Inquire  about  the  status  of  any  job  in  the  system 

FETCH  Retrieve  job  output  at  a  terminal 

HOLD  Move  jobs  from  a  wait  queue  to  a  hold  queue  or  vice  versa 
RELEASE  . 

PRINT  Release  output  from  the  hold  queue  for  printing  or  punching 

CANCEL  Cancel  executing  jobs  or  suppress  output  of  jobs  in  an  input  or  out- 

PURGE  put  queue 

ROUTE  Change  the  device  to  which  the  job's  output  will  be  sent 

TO  Send  a  message  to  another  user  or  to  the  central  computer  operator 

MAIL  Send  all  or  part  of  an  active  file  to  another  user  or  to  the  system 

manager 
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The  Execute  Facility 


INTERACT  has  an  Execute  Command  Language  which  consists  of  all  the  standard  INTERACT 
commands  plus  a  set  of  logic  and  arithmetic  statements.  This  language  is  extremely  powerful,  yet 
easy  to  learn,  and  is  available  to  all  users  of  the  system. 

Execute  programs  may  be  prepared  by  the  user  to  perform  a  specific  function  and  can  be  executed 
from  any  INTERACT  terminal.  Any  of  the  INTERACT  commands  may  be  included  in  an  execute 
program.  These  programs  may  be  saved  and  retrieved  or  executed  by  a  single  command. 

Execute  routines  are  often  written  to  handle  frequently  used  functions.  For  instance,  an  execute 
routine  can  be  used  to  build  JCL  in  an  active  file  with  one  simple  command.  One  might  be  created  to 
search,  retrieve,  and  compile  information  from  personnel  files,  internal  telephone  directories, 
customer  lists  and  the  like. 

Several  INTERACT  commands  are  designed  specifically  for  the  execute  facility.  These  commands 
provide  a  high-level  programming  language  when  used  with  the  INTERACT  preprocessor.  With  this 
facility,  a  user  can  build  an  execute  program  that  will  receive  input  from  the  terminal  by  prompting 
the  user  for  variables,  verify  the  input,  control  the  sequence  and  content  of  its  statements  using 
decision-making  capabilities,  and  display  messages  to  the  terminal  during  processing. 

Execute  routines  can  also  be  written  to  perform  operating  system  functions  for  personnel  who  do 
not  have  prior  knowledge  of  programming.  An  execute  program  can  perform  a  task  in  minutes  that 
would  normally  require  hours  or  days.  For  performing  many  routine  functions  quickly  and  easily, 
the  execute  facility  is  unmatched  for  convenience. 
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EXECUTE  COMMANDS 


READ 


Obtain  input  from  an  active  file  or  directly  from  the  user 


IF 


Evaluate  expressions,  and  provide  conditional  execution  ability 


EXECUTE 


Load  and  execute  a  file,  or  cause  unconditional  branching 
within  an  execute  program 


COMMENT 


Display  messages  to  the  terminal 


RESTORE 


Move  the  current  execute  file  to  an  active  file 


SAVE  EXEC  Save,  erase,  display  online  or  offline,  punch,  submit  to  another 

CLEAR  EXEC  user  or  to  the  central  computer,  or  copy  to  an  active  file  all  or 

LIST  EXEC  part  of  the  user's  execute  file 
PUNCH  EXEC 
POINT  EXEC 
MAIL  EXEC 
COPY  EXEC 
RUN  EXEC 

SET  OR  SHOW: 

RETURN  Provide  "branch  and  link"  return  ability 

VALUE  Set  or  show  values  of  variables 

ESCAPE  Determine  where  points  of  substitution  should  be  made  or 

SKIP  bypassed,  or  reset  the  maximum  number  of  times  that  the 

RESCAN  preprocessor  will  scan  the  text. 

EXEC  Allow  messages  to  the  terminal  to  be  shortened  or  eliminated 
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Word  Procsssing 


The  INTERACT  word  processing  feature  has  the  ability  to  assist  the  user  in  the  preparation  of  high 
quahty  letters,  documents,  or  other  forms  of  text.  With  the  INTERACT  word  processing  feature, 
the  user  will  not  only  save  time  but  the  quality  of  all  documents  produced  will  be  superior  to  other 
forms  of  preparation. 

Commands  exist  to  center  text  and  to  format  text  with  even  left  or  right  margins.  Document  process- 
ing commands  perform  automatic  table  of  contents  preparation,  page  composition  and  numbering, 
and  handling  of  special  characters  such  as  superscripts  and  subscripts. 

By  using  a  combination  of  INTERACT  commands,  the  user  can  process  high  volume  applications 
such  as  letter  writing  or  label  generation  with  a  very  small  amount  of  manual  effort.  It  is  possible 
that  a  single  word  processing  application  could  justify  the  cost  of  INTERACT.  A  partial  list  of  the 
word  and  document  processing  commands  is: 

ALIGN  Reformat  lines  to  contain  no  more  than  or  exactly  the  number  of 

JUSTIFY        characters  specified  for  the  line  length. 

CENTER        Center  lines  of  text  within  a  line  length. 

PAGINATE    Create  pages  of  text  with  a  user  specified  number  of  lines  per  page. 
TITLE  Provide  a  heading  for  text  pages. 

FOOTER        Provide  a  footing  for  text  pages. 

SECTION       Delineate  a  section  title  to  be  included  in  the  table  of  contents  and 
specify  whether  or  not  it  is  to  be  underlined. 


INDENT        Specify  the  number  of  leading  spaces  to  be  added  to  each  line  and  the 
format  of  paragraphs  to  be  used. 
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Defining  Session  Parameters 


INTERACT  allows  the  user  to  set  values  for  some  of  the  command  parameters  and  terminal  set- 
tings. Once  a  command  parameter  is  set,  it  may  be  omitted  from  any  INTERACT  command  in 
which  it  appears.  Terminal  settings  (tabs,  line  length,  etc.)  also  may  be  set  differently  for  different 
types  of  text  entry.  In  addition,  the  user  may  ask  INTERACT  to  show  the  current  value  of  any  of 
these  predefined  parameters.  Values  can  be  set  or  shown  for  the  following  parameters: 


SET  or  SHOW    Specify  whether  backspaces  will  erase  characters  or  will  be  retained 


BACK 
NOBACK 


in  the  text. 


CURRENT 


Set  the  current  line  number. 


DELTA 


Set  the  line  number  increment. 


FASTLIST  Set  the  speed  of  listing  at  a  terminal  by  allowing  or  disallowing  the 
SLOWLIST        use  of  tabs. 


NAME 

PREFIX 

USER 

GROUP 

MEMBER 

LIBRARY 


Set  default  values  to  be  used  in  forming  an  INTERACT  data  set 
name. 


KEYWORD       Set  a  user's  keyword  for  security  measures. 


LENGTH 
TABS 
UPPER 
UPLOW 


Set  for  a  terminal:  line  lengths,  tab  positions,  and  uppercase  or  up- 
per/lowercase character  recognition. 


TERSE  Determine  if  INTERACT  will  issue  complete  or  abbreviated 

VERBOSE  responses. 

MODE  Set  either  automatic  or  nonautomatic  retry  for  commands  that 

fail. 

NOTIME  Determine  if  users  who  have  been  inactive  for  20  minutes  are  lo  be 

TIMEOUT         signed  off. 
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VOLUME 


Set  a  default  disk  volume  identification. 


FUNCTION  Assign  a  function  key  to  an  INTERACT  command. 
FILE  Set  the  attribute  of  a  file. 


In  addition  to  setting  and  showing  predefined  parameters,  INTERACT  allows  the  value  of  certain 
system  parameters  to  be  displayed,  as  follows: 


SHOW 
CATLG 
DIRECTORY 
DSNAMES 

TIME 
DATE 

COLUMNS 

FIRST 
LAST 
NEXT,  etc. 

COUNT 
USER(S) 
LINE(S) 

FREE 
IDLE 
MINFREE 

SPACE 
TRACKS 

JOBNO 


VOLUME(S) 

MESSAGE 

SIZE 


List  data  set  names  or  index  pointers  in  the  system  catalog  or  a 
specified  volume,  or  members  in  a  PDS. 


Display  the  current  time  and  session  time,  or  time,  date,  and 
Julian  date. 

List  column  numbers  in  a  Hne. 

Display  the  value  of  the  specified  symbolic  line  number. 


Display  a  variety  of  information  regarding  users  and  lines  on  the 
system. 


Give  a  count  of  free  phone  lines  (i.e.,  INTERACT  lines  not  in  use) 
and  list  their  INTERACT  line  numbers. 


Display  tracks  available  for  all  users  or  a  single  user  on  specified 
volumes. 

Display  the  numeric  portion  of  the  job  name  assigned  by 
INTERACT. 

List  all  disk  packs  accessible  to  INTERACT. 

Display  the  contents  of  the  current  INTERACT  system  message. 

Display  line  numbers  of  lines  over,  under,  or  equal  to  a  specified 
number  of  characters  in  length. 


PAGES 


List  the  number  of  pages  of  text  in  an  active  file. 


16 


impiementing  INTERACT 

Installation.  INTERACT  is  easy  to  install  —  a  typical  installation  takes  less  than  60  minutes.  No 
special  system  generation  is  required  —  there  are  NO  operating  system  modifications.  INTERACT 
is  available  under  various  license  arrangements  designed  to  fit  each  installation's  financial  re- 
quirements, and  is  fully  maintained  and  continually  enhanced.  INTERACT  is  currently  in  use  at  in- 
stallations throughout  the  United  States,  under  a  variety  of  operating  systems. 

Training.  Users  can  learn  how  to  use  INTERACT  in  a  short  period  of  time.  Manuals  covering  basic 
operations,  advanced  techniques,  and  the  execute  facihty  are  supphed  with  the  system.  Documenta- 
tion is  most  effective  when  used  with  a  terminal  so  that  the  user  can  gain  hands-on  experience.  This 
approach  allows  users  to  become  acquainted  with  INTERACT  at  a  time  that  is  most  convenient  to 
them,  and  when  access  to  a  terminal  is  available. 

Documentation.  Customers  receive  complete  and  updated  documentation  for  all  the  features  of  the 
INTERACT  system. 

Software/Hardware  Requirements.  INTERACT  will  run  as  a  problem  program  on  any  of  the 
following  operating  systems: 

C 

OS/MFT  HASP 
OS/MVT  HASP 
VSl  JESl 
VS2  (SVS)  HASP 
VS2  (MVS)  JES2 

INTERACT  is  written  in  IBM  Assembler  Language  and  requires  one  region/partition  for  opera- 
tion. INTERACT  has  its  own  input/output  routines  and  uses  EXCP-level  programming. 

The  minimum  system,  model,  and  storage  size  required  by  INTERACT  is  an  IBM  System/360 
Model  50  with  512K  of  real  storage,  or  an  IBM  System/370  Model  135  with  512K  of  real  storage.  A 
typical  system  supporting  16  users  requires  approximately  256K  of  virtual  storage. 

Generally,  all  of  the  equipment  used  by  INTERACT  is  already  required  by  the  operating  system. 
Specific  requirements  are: 

□  Direct  access  storage.  Disk  space  is  required  for  storing  the  INTERACT  pro- 
gram and  for  text  stored  by  the  user.  Devices  used  by  INTERACT  can  be 
IBM  2314,  3330,  3330-11,  3340,  3350,  2305-1,  2305-2,  or  equivalent  devices. 
Approximately  10  megabytes  of  storage  are  required  for  the  INTERACT 
system. 

□  Tape  Drive.  A  9-track  tape  drive  is  required  for  loading  the  installation  tape. 


17 


Terminals.  Communications  may  be  supported  via  local  3270  display  ter- 
minals, 2741s  or  TTY-compatible  terminals  through  an  asynchronous  port  of 
a  270X  or  370X  control  unit;  remote  3270  display  terminals  attached  through 
a  bisynchronous  port  of  a  270X  or  370X  control  unit;  3767  terminals  in  TTY 
or  2741  mode;  or  equivalent  devices.  The  maximum  number  of  terminals 
that  can  be  attached  is  theoretically  32,000;  however,  the  amount  of  main 
storage  available  is  also  a  determining  factor.  A  major  feature  of  IN- 
TERACT is  its  ability  to  interface  to  terminals  through  a  variety  of  TP 
monitors  and  access  methods  such  as  SHADOW,  INTERCOMM,  and 
VTAM. 

High  Speed  Printer  Options.  If  uppercase  and  lowercase  printing  is  desired 
from  the  computer's  line  printer,  an  IBM  1403  or  321 1  printer  equipped  with 
the  universal  character  set  feature  and  the  TN  printing  arrangement,  or  a 
3800  Printing  System  (or  an  equivalent  device)  must  be  used. 
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In  ConcSusion... 


The  INTERACT  system  optimizes  computer  resources.  The  combination  of  features  in  INTERACT 
allows  text  entry  and  manipulation  to  be  made  with  exceptional  speed  and  ease.  INTERACT's 
remote  job  processing  ability  relieves  many  of  the  problems  associated  with  batch  runs  —  less  time  is 
spent  getting  information  into  and  out  of  the  computer. 

INTER.'\CT  is  compatible  with  existing  software  systems,  without  operating  system  modifications, 
and  can  make  a  computer  center  vastly  more  productive.  INTERACT  not  only  provides  increased 
productivity,  but  also  provides  greater  job  satisfaction. 
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DOCUMENTATION  COMiMENT  FORM 


INTERACT  Summary  Description 
March  1979 


Use  this  form  to  express  your  views  concerning  this  pubHcation.  All  comments  and  suggestions  are 
both  welcome  and  appreciated. 

Please  do  not  use  this  form  to  report  system  problems  or  to  request  additional  publications,  new 
release  materials,  etc.  System  problems  should  be  reported  on  Cullinane's  standard  Exception 
Report  form,  or  in  a  separate  letter  addressed  to  the  attention  of  the  appropriate  support  group. 
Requests  for  published  materials  should  be  addressed  to  the  attention  of  Distribution. 

SENDER  (fill  in  only  if  you  wish);       ,  _   "  ■  ~ 


(name)  (position) 


(  company) 


(  address) 


( city,  state,  zip) 

COMMENTS: 

Areas  of  comment  are  general  presentation,  format,  organization,  completeness,  clarity,  accuracy, 
etc.  If  a  comment  applies  to  a  specific  page  or  pages,  please  cite  the  page  number  (s). 


Thank  you  for  your  response. 


Order  Number:  TDIN-110-60 


fold 


Specialists  in  Data  Management  Softyvare   

First  Class 
Permit  No.  41947 
Wellesley,  Mass. 


Business  reply  mail.  No  postage  necessary  if  mailed  in  the  United  States. 
Postage  will  be  paid  by. 


Cullinane  Corporation 

20  William  Street 

Wellesley,  Massachusetts  02181 

Attn:  Documentation 
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DOCUMENTATION  COMMENT  FORM 


INTERACT  Summary  Description 
March  1979 


Use  this  form  to  express  your  views  concerning  this  publication.  All  comments  and  suggestions  are 
both  welcome  and  appreciated. 

Please  do  not  use  this  form  to  report  system  problems  or  to  request  additional  publications,  new 
release  materials,  etc.  System  problems  should  be  reported  on  Cullinane's  standard  Exception 
Report  form,  or  in  a  separate  letter  addressed  to  the  attention  of  the  appropriate  support  group. 
Requests  for  published  materials  should  be  addressed  to  the  attention  of  Distribution. 

SENDER  (fill  in  only  if  you  wish): 


(name)  (position) 


(  company) 


(  address) 


( city,  state,  zip) 


COMMENTS: 

Areas  of  comment  are  general  presentation,  format,  organization,  completeness,  clarity,  accuracy, 
etc.  If  a  comment  applies  to  a  specific  page  or  pages,  please  cite  the  page  number  (s). 


Tliank  you  for  your  response. 


Order  Number:  TDIN-110-60 


fold 


Specialists  in  Data  Management  Software 


First  Class 
Permit  No.  41947 
WeUesley,  Mass. 


Business  reply  mail.  No  postage  necessary  if  mailed  in  the  United  States. 
Posta>;e  hiU  be  paid  by: 


Cuilinane  Corporation 

20  William  Street 

Wellesley,  Massachusetts  02181 

Attn:  Documentation 


lo 
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IBM  SPF 


PROGRAM  PRODUCTS/SYSTEM 


PP  2.353 
Jan  80 


VM/CWS  -  3270  DISPLAY  SUPPORT  AND 
STRUCTURED  PROGRAMMING  FACILITY  (SPF/CMS) 
5748  -  XT3 

VM/CMS  -  3270  Display  Support  and  Structured  Programming  Facility 
(SPF/CMS).  Prog'-am  rJumber  C5748-XT3)  is  functionally  equivalent  to 
Version  2.2  of  the  SPF/TSO  Program  Product. 

\. 

The  two  Program  Products  are  fully  compatible  in  display  formats  and 
oporatlon.  except  for  those  features  which  are  explicitly  oriented  to  the 
VS2/TS0  or  VW/CMS  environment.  SPF/CMS  also  includes  a  utility 
which  permits  transfer  of  SPF  program  libraries  from  VS2/TS0  to 
VM/CMS. 

HIGHLIGHTS 

SPF/CMS  Is  a  program  development  tool  designed  to  take  advantage 
of  the  characteristics  of  IBM  3270  display  terminals,  and  to  increase 
programmer  productivity  in  the  VM/CMS  environment.  SPF  supports 
both  structured  and  conventional  programming  techniques.  It  can  be 
used  either  by  an  individual  programmer,  or  by  many  programmers 
working  together  on  a  pro;ect.  SPF  features  which  increase  program- 
mer productivity  and  sim.plify  operation  include; 

•  Display  presentations  and  menus  which  prompt  the  user,  reduce 
keystrokes,  and  minimize  the  opportunity  for  error. 

•  Support  for  multi-level  programming  libraries,  automatic  collection 
of  library  activity  statistics,  and  printing  of  library  contents. 

•  Full  screen,  context  editing  which  allows  additions  and  changes  to 
multiple  lines  In  a  single  interaction. 

•  Simple  cne-characfer  edit  commands  for  Inserting,  deleting, 
duplicating,  or  rearranging  lines  of  source  data. 

•  Forward,  backward,  and  sidev/ays  scrolling  of  source  data  or 
listings,  plus  the  ability  to  locate  information  by  character  string  or 
line  number. 

•  Split  screen,  allowing  two  SPF  functions  to  be  performed 
Independently  on  the  same  display  terminal. 

•  Use  of  program  function  keys  for  frequently  performed  SPF 
operations  end  commands. 

•  Menu-driven  utilities  for  specification,  maintenance  and  current 
status  display  of  i.b'anes  and  tiles. 

•  Menu  interface  to  standard  language  processors  (compilers  and 
assembler)  tor  execution  In  the  foreground  or  CMS  batch  machine. 

•  Document  preparation  support,  including  text  editing  features  and 
a  menu  Interface  to  the  SCRIPT/VS  Document  Composition 
Facility. 

•  Hardcopy  log  summarizing  significant  user  actions  during  the 
session. 

•  Online  tutorial  for  Instruction  and  reference  -  especially  valuable 
for  the  occasional  or  novice  user  of  SPF 

SPF  operates  as  a  VM/CMS  application  and  Is  Invoked  simply  by 
eniiirlng  the  command  "SPF".  It  operates  on  a  24-line,  32-line,  or 
43-Iino  lEM  3270  display  station,  equipped  with  either  12  or  24 
program  function  Keys. 

DISPLAY  FORMAT 

SPF  uses  four  basic  typos  of  display  presentations; 

•  Option  Ssiection  f^enut  -  where  the  user  selects  from  a  list  of 
options  by  typing  a  number  and  pressing  the  ENTER  key. 

•  ParBm»t»f  Entry  M»n'j»  -  where  the  user  supplies  parameters  by 
filling  In  Itifcoloa  fields.  In  many  coses,  SPF  displays  default 
valuos.  bcsoa  on  what  the  user  last  entered.  The  user  may 
ovort/po  the  displayed  defaults. 

•  f.'smbsr  s»i«ction  Lists  -  for  displaying  a  list  of  members  In  a 
MACLIB  or  SPF  library.  The  user  may  select  a  member  by 
Ghtori.-g  a  ono-cnaractor  code  In  front  of  the  appropriate  member 
narro. 

•  Data  Ditplays  -  for  displaying  source  code  or  listings  for  editing  and 
trcvsirg  Tr-o  f.rst  [,,0  linos  of  the  display  include  a  tit'e.  message 
aro").  cc^r^and  Input  (leld.  and  scroll  amount  field.  The  re.-naining 
lir.rjs  conta.n  the  cata. 

PP03PAM  ACCESS  ArjD  FUNCTION  KEYS 

Tr-.  ;.-cg'B~i  a:co33  (P,i2)  and  the  12  or  24  program  'unction  (PF) 
"' "'''^^      "-^■-'^sf  ccmrr-ionly  used  cr  special  SPF  operations, 

•  r'ESHC  ^  -  -o  re:;'5p'ay  Te  ccntonts  of  the  screen. 

CCPCLL  -  to  r-3ye  ;ro  screen  win:!ow  up,  down,  left,  or  ng^^t  by  the 
Q-^C'^'.'  s--/.r  ,1  v.-H  scroll  amount  'ield 

?l'''"'J  ^^''^^^  -  '0  e-'er  spht-.  screen  mode  or  to  adjust  the 
oca:  ens  c*  t-e  spi  t  based  on  the  current  cursor  position, 

p=(;nt  -  to  cita.n  a  haraccpy  snapsnct  of  the  current  screen  i-^age. 

HELP  -  to  cbta  n  edd  t.onal  In'or.mation  about  an  error  message  or 
;6-o'ai  ir'orrr.ation  about  SPF  commancs  anq  options. 


•  END  -  to  terminate  the  current  operation  and  return  to  the  previous 
display  or  menu.  ' 

Users  may  rearrange  the  assignment  of  SPF-defmed  PF  key  functions, 
and  may  equate  additional  PF  keys  to  edit  and  browse  commands. 

MAJOR  FUNCTIONS 

The  maior  functions  provided  by  SPF  are; 

SPF  PARMS  -  to  specify  terminal  type  and  user  options. 

BROWSE  -  to  display  source  data  and  output  listings. 

EDIT  -  to  create  or  change  source  data. 

UTILITIES  -  to  perform  SPF  utility  functions. 

FOREGROUND  -  to  compile,  assemble,  or  debug. 

BATCH  PROCESSING  -  to  compile  or  assemble  via  a  CMS  batch 
machine. 

CP/CMS  -  to  enter  a  CP  or  CMS  command,  or  EXEC. 
TUTORIAL  -  to  display  information  about  SPF. 
EXIT  -  to  terminate  SPF. 
SPF  FARMS 

The  SPF  parms  function  allows  the  user  to  specify  terminal  type, 
mono/dual  case,  number  of  program  function  (PF)  keys,  default 
options  for  list  and  log  files,  and  PF  key  definitions. 

BROWSE 

The  browse  option  allows  the  user  to  display  source  programs,  output 
listings,  test  data,  etc.,  stored  in  SPF  libraries,  MACLlBs  or  DASD 
resident  sequential  CMS  files  with  the  following  characteristics; 

•  Fixed  or  variable  record  formats. 

•  Records  with  or  without  printer  control  characters. 

•  Records  with  logical  record  length  up  to  and  including  32.767 
bytes. 

The  screen  window  for  browsing  is  22.  30  or  41  lines  deep  depending 
upon  terminal  type.  (Tv/o  lines  are  reserved  at  the  top  of  the  screen  tor 
title  information,  messages,  command  entry,  and  display  of  the  scroll 
amount  )  Four-way  scrolling  is  available  via  the  scroll  PF  keys.  In 
addition,  FIND  and  LOCATE  commands  may  be  used  to  scroll  to  a 
designated  character  string,  line  number,  or  symbolic  label. 

EDIT 

The  edit  option  allows  the  user  to  create,  display,  and  modify  source 
data  (program  code,  test  data,  documentation,  etc.)  stored  in  SPF 
libraries  or  DASD-resident  sequential  CMS  files  with  the  following 
characteristics: 

•  Fixed  or  variable  record  formats. 

•  Records  with  or  without  printer  control  characters. 

•  Records  with  logical  record  lengths  of  up  to  and  including  255 
bytes  but  not  less  than  10  bytes. 

The  edit  display  is  similar  to  browse  except  that  each  line  consists  of  a 
six-column  sequence  number  field  followed  by  a  72-column  data  field. 
Four-way  scrolling  is  available  via  the  scroll  PF  keys. 

To  modify  information  on  the  screen,  the  user  simply  moves  the  cursor 
to  the  desired  location  and  enters  the  new  information.  Several  lines 
may  be  modified  before  pressing  the  ENTER  key.  Lines  may  be 
deleted,  inserted,  shifted  left  or  right  (for  indentation  changes), 
duplicated,  or  rearranged  by  overtyping  the  sequence  number  fields 
with  line  commands  consisting  of  one  or  two  characters  (e.g.,  D  tor 
delete,  I  for  insert,  M  (or  move).  In  general,  several  line  commands  as 
well  as  data  modifications  may  be  typed  before  pressing  the  ENTER 
key. 

In  addition,  primary  commands  may  be  entered  at  the  top  of  the  screen 
to  find  and  change  designated  character  strings,  to  control  sequence 
numbering  and  character  translation,  to  submit  the  data  to  the  job 
stream,  to  save  the  edited  data,  or  to  cancel  without  saving, 

UTILITIES 

The  SPF  utility  function  allows  the  user  to  select  one  of  the  fcHowmg 
options. 

Library  Utilities  -  to  ccrnpross  a  MACLIB.  to  print  a  file,  or  to  delete. 

rename,  or  print  selecteO  .r  embors  of  a  MACLIB  or  SPF  htra.'y 

File  Utility  -  to  specify  a  new  SPF  '  prary,  to  rename  or  delete  a  file 
or  SPF  library  or  to  display  die  or  l.brary  .ntorm.iiion. 

MOVE/COPY  -  to  r^ove  cr  copy  an  entire  f  'e  or  selected  me'^bers 
of  a  MACLIB  or  SPF  -.trary 

Project  Utility  -  to  print  or  disp'ay  Information  about  SPF  I  bra'  es. 

Reset  SPF  Statistics  -  to  Create,  update  Or  delete  statistics  for  an 
SPF  library,  and  optionally  reset  sequence  numbers. 


PROGRAM  PRODUCTS/SYSTEM 


PP  2.354 
Jan  80 


SPF/CMS  (cont'd) 

•  Hardcopy  Utility  -  to  Initiate  printing  or  punching  of  a  sequential 
CMS  tile  or  memtor  ot  a  MACLIB  or  SPF  library. 

•  R«trlev«  Utility  -  to  transfer  SPF  libraries  which  have  been  dumped 
to  tape  (via  lEHfy'OVE)  from  SPF/TSO  to  SPF/CMS. 

•  SCRIPT/VS  Utility  -  to  allow  formatting,  displaying  and  printing  of 
documentation  rraintalned  in  SPF  libraries  or  sequential  CMS  files. 
Use  of  this  feature  requires  that  the  SCRIPT/VS  Document 
Composition  Faci.i'y  be  Installed. 

FORECaOUND  PROCESSING 

The  foreground  option  provides  an  Interface  with  standard  language 
processors  tor  foreground  compilation,  assembly.  CMS  loading,  or 
debugging  of  programs  stored  in  SPF  libraries. 

BATCH  PROCESSING 

The  batch  processing  option  provides  an  interface  with  standard 
language  processors  for  CMS  batch  machine  compilation  or  assembly 
of  programs  stored  In  SPF  libraries.  For  other  batch  machine  Jobs,  the 
CP  SPOOL  and  PUNCH  commands  or  some  EXEC  may  be  entered  via 
the  CMS  command  option  (primary  option  6). 

CP/CMS  COMMAND 

The  CP/CMS  command  option  displays  a  menu  on  which  any  CP  or 
CMS  commend  or  EXEC  may  be  entered  without  leaving  SPF. 

TUTORIAL 

The  SPF  tutorial  provides  Immediate  online  reference  and  Instruction 
on  how  to  use  SPF.  It  may  be  viewed  sequentially  from  beginning  to 
end.  or  randomly  by  selecting  topics  from  a  table  of  contents  or  Index. 
It  may  be  entered  from  the  primary  option  menu,  or  from  another  SPF 
Option  by  pressing  the  Help  PF  key. 

SPECIFIED  OPERATING  ENVIRONMENT 

Machino  R«qulrom«nta 

The  computer  system  requirements  are  the  same  as  needed  for 
VM/370;  that  Is  an  IBM  System  370  model  135  and  up  with  at  least 
3e4K  real  storage,  or  a  4331  or  4341. 

The  storage  requirements  for  the  user's  VM  machine  will  vary 
depending  upon  the  size  of  the  files  being  edited  and  the  extent  that 
■"split-screen"  will  bo  used.  The  SPF  programs  are  reenterable  and 
should  be  placed  In  a  discontiguous  shared  segment  area.  This  will 
reduce  the  storage  roquirem.ents  (or  user  machines  and  should  also 
Improve  performance  v/hen  there  are  multiple  SPF  users  online. 

The  minimum  virtual  machine  size  Is  51 2K  If  SPF  resides  In  the 
discontiguous  shared  area.  If  SPF  does  not  reside  In  the  discontiguous 
shared  a.'oa.  a  virtual  rr-.achino  size  of  75aK  Is  recommended. 

T»rmlnili 

SPF  supports  the  following  IBM  3270  Display  Stations: 

•  3275  Model  2: 

•  3276  f/odo;3  2.  3.  and  4; 

•  3277  f/odol  2  (Iccal  or  remote  attachm.ent); 

•  3278  Models  2.  3.  and  4  (local  or  remote  attachment). 

The  following  keyboards  are  supported; 
For  3275  or  3277  display  stations: 

•  78  Key  EBCDIC  Cporoior  Console  (foature  »4632); 

•  78  Key  EBCDIC  Typowritor  (foaluro  =-4633); 

•  78  Key  ASCII  Typowritor  (feature  :^4635); 

•  78  Key  EBCDIC  Typownlor/APL  (foature  ^4638  (or  3277  only), 
when  oporctod  v/itn  APL  switch  OFF; 

For  3276  or  3278  display  stations; 

•  75  Key  EBCDIC  Typewriter  (feature  "4621); 

•  75  Key  ASCII  Typo//ri!or  (feature  =4624); 

•  87  Key  EBCDIC  Typowritor  Coaturo  =4627); 

•  87  Key  ASCII  T/ro//ri!or  (loature  =4628). 

The  standard  chamcor  sot  (94  graphics  plus  blank  and  null)  Is 
sucponed  on  3:75  una  3278  display  stations. 

The  audible  e'arm  (Foaturo  =1090)  Is  supported,  but  not  required, 
ins^aiiancn  c(  t*-o  auT  b^o  alarm  'eaturo  Is  strongly  recommended  to 
onr.ance  U5at:i'ty.  T,-o  niarri  19  aour.dod  by  SPF  whenever  a  warning 
or  error  m.ossngo  -s  rj  -^oiiyr,'; 

Programming  r--.;u:r3men;j 

Thi.  p'og'.aTi  c-o-Juct  ;s  released  to  work  with  VM/370  Roioaso  5  and 
S'jtooq'jort  r...  end  r-o:,;  :<Vion  levels  u'l'ass  othorwise  stated. 

P^ro-o^Tj'S  to  '3  •■•r.ij-  '-0  vf.'/  S,srem  E*tuns;on  program  product. 
(^74^./E".)  or  '-10  .''.'  Ease  Sys:L-m  Extonsions  program  product' 
('745-/XS). 


CUSTOMER  RESPONSIBILITIES 

The  customer  must  have  installed  the  prerequisite  programs  and  the 
appropriate  processing  programs  described  under  compatibility  for  use 
of  the  SPF  foreground  and  batch  processing  (unctions, 

COMPATIBILITY 

SPF  operates  as  a  CMS  command.  SPF  provides  menu  Interfaces  with 
the  following  IBM  processing  programs  for  foreground  and  batch 
execution: 


VM/370  Assembler 
COBOL-OS/VS  Compiler  and  Library 
COBOL  Interactive  Debug 

(foreground  only) 
FORTRAN  IV  G1  Compiler 
FORTRAN  Interactive  Debug 

(foreground  only) 
PL /I  OS  Checkout  Compiler 
PL/I  OS  Optimizing  Compiler 


5740-CB1 

5734-034 
5734-F02 

5734-F05 
5734-PL2 
5734-PL1 


All  the  program-numbered  Items  above  can  be  ordered  separately 
under  IBM  program  product  licensing  agreements.  The  appropriate 
processing  programs  must  be  Installed  to  use  the  SPF  foreground  and 
batch  processing  functions. 

SPF  also  provides  a  menu  Interface  to  SCRIPT/VS  to  allow  formatting, 
display,  and  printing  of  text  maintained  In  SPF  libraries  or  CMS 
sequential  flies.  Use  of  this  feature  requires  Installation  of  the  following 
IBM  program  product: 

Document  Composition  Facility  (SCRIPT/VS)  574&-XX9 
(with  the  Foreground  Environment  Feature) 

General  Documentation:  Available  from  Mechanlcsburg. 

General  Information  Manual 
Licensed  Program  Design  Oblectives 

Program  Servlco:  See  PP  Index. 
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and  translated  into  Assembler  Lan- 
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